ExpressionBuilderCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una raccolta di oggetti ExpressionBuilder. La classe non può essere ereditata.

public ref class ExpressionBuilderCollection sealed : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ExpressionBuilder))]
public sealed class ExpressionBuilderCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ExpressionBuilder))>]
type ExpressionBuilderCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class ExpressionBuilderCollection
Inherits ConfigurationElementCollection

Ereditarietà: Object

ConfigurationElement

ConfigurationElementCollection
ExpressionBuilderCollection

Attributi: ConfigurationCollectionAttribute

Esempio

Questa sezione fornisce due esempi di codice. La prima illustra come specificare in modo dichiarativo i valori per diverse proprietà della ExpressionBuilderCollection classe. Il secondo illustra come usare i membri della ExpressionBuilderCollection classe.

Nell'esempio di file di configurazione seguente viene illustrato come specificare in modo dichiarativo i valori per diverse proprietà della ExpressionBuilderCollection classe.

<system.web>  
  <compilation>   
    <expressionBuilders>  
      <add   
        expressionPrefix="Resources"   
        type="System.Web.Compilation.ResourceExpressionBuilder"/>  
      <add   
        expressionPrefix="ConnectionStrings"   
        type="System.Web.Compilation.  
        ConnectionStringsExpressionBuilder"/>  
      <add expressionPrefix="AppSettings"   
        type="System.Web.Compilation.AppSettingsExpressionBuilder" />  
    </expressionBuilders>  
  </compilation>  
</system.web>

Nell'esempio di codice seguente viene illustrato come usare i membri della ExpressionBuilderCollection classe.

#region Using directives

using System;
using System.Configuration;
using System.Web.Configuration;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingExpressionBuildCollection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config =
          WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        CompilationSection configSection =
          (CompilationSection)config.GetSection("system.web/compilation");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);

        // Create a new ExpressionBuilder reference.
        ExpressionBuilder myExpressionBuilder =
          new ExpressionBuilder("myCustomExpression", "MyCustomExpressionBuilder");
        // Add an ExpressionBuilder to the configuration.
        configSection.ExpressionBuilders.Add(myExpressionBuilder);

        // Add an ExpressionBuilder to the configuration.
        ExpressionBuilder myExpressionBuilder2 =
          new ExpressionBuilder("myCustomExpression2", "MyCustomExpressionBuilder2");
        configSection.ExpressionBuilders.Add(myExpressionBuilder2);

        // Display the ExpressionBuilder count.
        Console.WriteLine("ExpressionBuilder Count: {0}",
          configSection.ExpressionBuilders.Count);

        // Display the ExpressionBuildersCollection details.
        int i = 1;
        int j = 1;
        foreach (ExpressionBuilder expressionBuilder in configSection.ExpressionBuilders)
        {
          Console.WriteLine();
          Console.WriteLine("ExpressionBuilder {0} Details:", i);
          Console.WriteLine("Type: {0}", expressionBuilder.ElementInformation.Type);
          Console.WriteLine("Source: {0}", expressionBuilder.ElementInformation.Source);
          Console.WriteLine("LineNumber: {0}", expressionBuilder.ElementInformation.LineNumber);
          Console.WriteLine("Properties Count: {0}", expressionBuilder.ElementInformation.Properties.Count);
          j = 1;
          foreach (PropertyInformation propertyItem in expressionBuilder.ElementInformation.Properties)
          {
            Console.WriteLine("Property {0} Name: {1}", j, propertyItem.Name);
            Console.WriteLine("Property {0} Value: {1}", j, propertyItem.Value);
            ++j;
          }
          ++i;
        }

        // Remove an ExpressionBuilder.
        configSection.ExpressionBuilders.RemoveAt
          (configSection.ExpressionBuilders.Count-1);

        // Remove an ExpressionBuilder.
        configSection.ExpressionBuilders.Remove("myCustomExpression");

        // Update if not locked.
        if (!configSection.SectionInformation.IsLocked)
        {
          config.Save();
          Console.WriteLine("** Configuration updated.");
        }
        else
        {
          Console.WriteLine("** Could not update, section is locked.");
        }
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait.
      Console.ReadLine();
    }
  }
}

Imports System.Configuration
Imports System.Web.Configuration

Namespace Samples.Aspnet.SystemWebConfiguration
  Class UsingExpressionBuildCollection
    Public Shared Sub Main()
      Try
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As System.Configuration.Configuration = _
         WebConfigurationManager.OpenWebConfiguration(configPath)

        ' Get the section related object.
        Dim configSection As System.Web.Configuration.CompilationSection = _
         CType(config.GetSection("system.web/compilation"), _
         System.Web.Configuration.CompilationSection)

        ' Display title and info.
        Console.WriteLine("ASP.NET Configuration Info")
        Console.WriteLine()

        ' Display Config details.
        Console.WriteLine("File Path: {0}", _
         config.FilePath)
        Console.WriteLine("Section Path: {0}", _
         configSection.SectionInformation.Name)

        ' Create a new ExpressionBuilder reference.
        Dim myExpressionBuilder As ExpressionBuilder = _
          New ExpressionBuilder("myCustomExpression", "MyCustomExpressionBuilder")
        ' Add an ExpressionBuilder to the configuration.
        configSection.ExpressionBuilders.Add(myExpressionBuilder)

        ' Add an ExpressionBuilder to the configuration.
        Dim myExpressionBuilder2 As ExpressionBuilder = _
         New ExpressionBuilder("myCustomExpression2", "MyCustomExpressionBuilder2")
        configSection.ExpressionBuilders.Add(myExpressionBuilder2)

        ' Display the ExpressionBuilder count.
        Console.WriteLine("ExpressionBuilder Count: {0}", _
          configSection.ExpressionBuilders.Count)

        ' Display the ExpressionBuildersCollection details.
        Dim i = 1
        Dim j = 1
        For Each expressionBuilder As ExpressionBuilder In configSection.ExpressionBuilders()
          Console.WriteLine()
          Console.WriteLine("ExpressionBuilder {0} Details:", i)
          Console.WriteLine("Type: {0}", expressionBuilder.ElementInformation.Type)
          Console.WriteLine("Source: {0}", expressionBuilder.ElementInformation.Source)
          Console.WriteLine("LineNumber: {0}", expressionBuilder.ElementInformation.LineNumber)
          Console.WriteLine("Properties Count: {0}", expressionBuilder.ElementInformation.Properties.Count)
          j = 1
          For Each propertyItem As PropertyInformation In expressionBuilder.ElementInformation.Properties
            Console.WriteLine("Property {0} Name: {1}", j, propertyItem.Name)
            Console.WriteLine("Property {0} Value: {1}", j, propertyItem.Value)
            j = j + 1
          Next
          i = i + 1
        Next

        ' Remove an ExpressionBuilder.
        configSection.ExpressionBuilders.RemoveAt _
         (configSection.ExpressionBuilders.Count - 1)

        ' Remove an ExpressionBuilder.
        configSection.ExpressionBuilders.Remove("myCustomExpression")

        ' Update if not locked.
        If Not configSection.SectionInformation.IsLocked Then
          config.Save()
          Console.WriteLine("** Configuration updated.")
        Else
          Console.WriteLine("** Could not update, section is locked.")
        End If

      Catch e As Exception
        ' Unknown error.
        Console.WriteLine(e.ToString())
      End Try

      ' Display and wait
      Console.ReadLine()
    End Sub
  End Class
End Namespace

Commenti

La ExpressionBuilderCollection classe non fa riferimento a alcun elemento effettivo nel file di configurazione sottostante. Si tratta di un costrutto che consente di accedere facilmente alle informazioni di compilazione contenute.

Costruttori

ExpressionBuilderCollection()

Inizializza una nuova istanza della classe ExpressionBuilderCollection.

Proprietà

AddElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di aggiunta nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ClearElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di cancellazione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
CollectionType	Ottiene il tipo di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
Count	Ottiene il numero di elementi nella raccolta. (Ereditato da ConfigurationElementCollection)
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di livello superiore che rappresenta la gerarchia di configurazione cui appartiene l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un oggetto ElementInformation contenente le funzionalità e le informazioni non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementName	Ottiene il nome utilizzato per identificare questo insieme di elementi nel file di configurazione quando è sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EmitClear	Ottiene o imposta un valore che specifica se l'insieme è stato cancellato. (Ereditato da ConfigurationElementCollection)
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la proprietà CurrentConfiguration è `null`. (Ereditato da ConfigurationElement)
IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato. (Ereditato da ConfigurationElementCollection)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[Int32]	Ottiene o imposta la classe ExpressionBuilder nell'insieme ExpressionBuilderCollection in corrispondenza dell'indice specificato.
Item[String]	Ottiene l'oggetto ExpressionBuilder con il nome specificato.
LockAllAttributesExcept	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Properties	Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement)
RemoveElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di rimozione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
SyncRoot	Ottiene un oggetto utilizzato per sincronizzare l'accesso alla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
ThrowOnDuplicate	Ottiene un valore che indica se il tentativo di aggiungere una classe ConfigurationElement duplicata alla classe ConfigurationElementCollection genererà un'eccezione. (Ereditato da ConfigurationElementCollection)

Metodi

Add(ExpressionBuilder)	Aggiunge un oggetto ExpressionBuilder all'oggetto ExpressionBuilderCollection.
BaseAdd(ConfigurationElement)	Aggiunge un elemento di configurazione a ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseClear()	Rimuove tutti gli oggetti dell'elemento di configurazione dall'insieme. (Ereditato da ConfigurationElementCollection)
BaseGet(Int32)	Ottiene l'elemento di configurazione in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseGet(Object)	Restituisce l'elemento di configurazione con la chiave specificata. (Ereditato da ConfigurationElementCollection)
BaseGetAllKeys()	Restituisce una matrice delle chiavi di tutti gli elementi di configurazione inclusi nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseGetKey(Int32)	Ottiene la chiave per la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica l'indice della classe ConfigurationElement specificata. (Ereditato da ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se la classe ConfigurationElement con la chiave specificata è stata rimossa dalla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseRemove(Object)	Rimuove un oggetto ConfigurationElement dalla raccolta. (Ereditato da ConfigurationElementCollection)
BaseRemoveAt(Int32)	Rimuove la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
Clear()	Cancella tutti gli oggetti ExpressionBuilder dall'insieme ExpressionBuilderCollection.
CopyTo(ConfigurationElement[], Int32)	Copia il contenuto della classe ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection)
CreateNewElement()	Quando è sottoposto a override in una classe derivata, crea un nuovo elemento ConfigurationElement. (Ereditato da ConfigurationElementCollection)
CreateNewElement(String)	Crea una nuova classe ConfigurationElement quando è sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta la classe ConfigurationElementCollection con l'oggetto specificato. (Ereditato da ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Ottiene la chiave per un elemento di configurazione specificato quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
GetEnumerator()	Ottiene un'interfaccia IEnumerator utilizzata per scorrere la classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome di assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init()	Ripristina lo stato iniziale dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
InitializeDefault()	Da utilizzare per inizializzare un insieme predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsElementName(String)	Indica se la classe ConfigurationElement specificata esiste nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se è possibile rimuovere l'oggetto ConfigurationElement da ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsModified()	Indica se questa classe ConfigurationElementCollection è stata modificata dall'ultimo salvataggio o caricamento durante l'override in una classe derivata. (Ereditato da ConfigurationElementCollection)
IsReadOnly()	Indica se l'oggetto ConfigurationElementCollection è in sola lettura. (Ereditato da ConfigurationElementCollection)
ListErrors(IList)	Aggiunge all'elenco passato gli errori di proprietà non valida di questo oggetto ConfigurationElement e di tutti i sottoelementi. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Fa generare un'eccezione al sistema di configurazione. (Ereditato da ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando una proprietà obbligatoria non viene trovata. (Ereditato da ConfigurationElement)
PostDeserialize()	Da chiamare dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Da chiamare prima della serializzazione. (Ereditato da ConfigurationElement)
Remove(String)	Rimuove un oggetto ExpressionBuilder dalla raccolta ExpressionBuilderCollection.
RemoveAt(Int32)	Rimuove un oggetto ExpressionBuilder dalla raccolta ExpressionBuilderCollection.
Reset(ConfigurationElement)	Reimposta la classe ConfigurationElementCollection sullo stato non modificato quando viene sottoposta a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
ResetModified()	Reimposta il valore della proprietà IsModified() su `false` quando viene sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Scrive i dati di configurazione in un elemento XML del file di configurazione quando vengono sottoposti a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione in caso di implementazione in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la proprietà IsReadOnly() per l'oggetto ConfigurationElementCollection e per tutti i sottoelementi. (Ereditato da ConfigurationElementCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte l'effetto di unione delle informazioni sulla configurazione da livelli diversi della gerarchia di configurazione. (Ereditato da ConfigurationElementCollection)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia ConfigurationElementCollection in una matrice.

(Ereditato da ConfigurationElementCollection)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a

Condividi tramite