ExpressionBuilderCollection Classe

Definizione

Rappresenta una raccolta di ExpressionBuilder oggetti . 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à
Attributi

Esempio

In questa sezione vengono forniti 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 ad alcun elemento effettivo nel file di configurazione sottostante. Si tratta di un costrutto che consente di accedere facilmente alle informazioni di compilazione contenute.

Costruttori

Nome Descrizione
ExpressionBuilderCollection()

Inizializza una nuova istanza della classe ExpressionBuilderCollection.

Proprietà

Nome Descrizione
AddElementName

Ottiene o imposta il nome del ConfigurationElement da associare all'operazione di aggiunta nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
ClearElementName

Ottiene o imposta il nome del ConfigurationElement da associare all'operazione di cancellazione nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
CollectionType

Ottiene il tipo del ConfigurationElementCollection.

(Ereditato da ConfigurationElementCollection)
Count

Ottiene il numero di elementi nella raccolta.

(Ereditato da ConfigurationElementCollection)
CurrentConfiguration

Ottiene un riferimento all'istanza di Configuration di primo livello che rappresenta la gerarchia di configurazione a cui appartiene l'istanza di ConfigurationElement corrente.

(Ereditato da ConfigurationElement)
ElementInformation

Ottiene un oggetto ElementInformation che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationElement.

(Ereditato da ConfigurationElement)
ElementName

Ottiene il nome utilizzato per identificare questa raccolta di elementi nel file di configurazione quando ne viene eseguito l'override in una 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 l'oggetto ExpressionBuilder in corrispondenza dell'indice specificato nell'insieme ExpressionBuilderCollection .

Item[String]

Ottiene l'oggetto ExpressionBuilder con il nome specificato.

LockAllAttributesExcept

Ottiene la raccolta di attributi bloccati.

(Ereditato da ConfigurationElement)
LockAllElementsExcept

Ottiene la raccolta di elementi bloccati.

(Ereditato da ConfigurationElement)
LockAttributes

Ottiene la raccolta di attributi bloccati.

(Ereditato da ConfigurationElement)
LockElements

Ottiene la raccolta 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 del ConfigurationElement da associare all'operazione di rimozione nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
SyncRoot

Ottiene un oggetto utilizzato per sincronizzare l'accesso al ConfigurationElementCollection.

(Ereditato da ConfigurationElementCollection)
ThrowOnDuplicate

Ottiene un valore che indica se un tentativo di aggiungere un ConfigurationElement duplicato al ConfigurationElementCollection genererà un'eccezione.

(Ereditato da ConfigurationElementCollection)

Metodi

Nome Descrizione
Add(ExpressionBuilder)

Aggiunge un ExpressionBuilder oggetto all'oggetto ExpressionBuilderCollection.

BaseAdd(ConfigurationElement, Boolean)

Aggiunge un elemento di configurazione alla raccolta di elementi di configurazione.

(Ereditato da ConfigurationElementCollection)
BaseAdd(ConfigurationElement)

Aggiunge un elemento di configurazione al ConfigurationElementCollection.

(Ereditato da ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)

Aggiunge un elemento di configurazione alla raccolta di elementi di configurazione.

(Ereditato da ConfigurationElementCollection)
BaseClear()

Rimuove tutti gli oggetti elemento di configurazione dalla raccolta.

(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 per tutti gli elementi di configurazione contenuti nella ConfigurationElementCollection.

(Ereditato da ConfigurationElementCollection)
BaseGetKey(Int32)

Ottiene la chiave per il ConfigurationElement in corrispondenza della posizione di indice specificata.

(Ereditato da ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)

Indica l'indice del ConfigurationElementspecificato.

(Ereditato da ConfigurationElementCollection)
BaseIsRemoved(Object)

Indica se il ConfigurationElement con la chiave specificata è stato rimosso dal ConfigurationElementCollection.

(Ereditato da ConfigurationElementCollection)
BaseRemove(Object)

Rimuove un ConfigurationElement dalla raccolta.

(Ereditato da ConfigurationElementCollection)
BaseRemoveAt(Int32)

Rimuove il ConfigurationElement in corrispondenza della posizione di indice specificata.

(Ereditato da ConfigurationElementCollection)
Clear()

Cancella tutti gli ExpressionBuilder oggetti dall'insieme ExpressionBuilderCollection .

CopyTo(ConfigurationElement[], Int32)

Copia il contenuto del ConfigurationElementCollection in una matrice.

(Ereditato da ConfigurationElementCollection)
CreateNewElement()

Quando sottoposto a override in una classe derivata, crea un nuovo ConfigurationElementoggetto .

(Ereditato da ConfigurationElementCollection)
CreateNewElement(String)

Crea una nuova ConfigurationElement quando ne viene eseguito l'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 il ConfigurationElementCollection con l'oggetto specificato.

(Ereditato da ConfigurationElementCollection)
GetElementKey(ConfigurationElement)

Ottiene la chiave dell'elemento per un elemento di configurazione specificato quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
GetEnumerator()

Ottiene un IEnumerator oggetto utilizzato per scorrere l'oggetto 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 dell'assembly specificato.

(Ereditato da ConfigurationElement)
GetTransformedTypeString(String)

Restituisce la versione trasformata del nome del tipo specificato.

(Ereditato da ConfigurationElement)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
Init()

Imposta l'oggetto ConfigurationElement sullo stato iniziale.

(Ereditato da ConfigurationElement)
InitializeDefault()

Utilizzato per inizializzare un set predefinito di valori per l'oggetto ConfigurationElement.

(Ereditato da ConfigurationElement)
IsElementName(String)

Indica se il ConfigurationElement specificato esiste nel ConfigurationElementCollection.

(Ereditato da ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)

Indica se il ConfigurationElement specificato può essere rimosso dal ConfigurationElementCollection.

(Ereditato da ConfigurationElementCollection)
IsModified()

Indica se questa ConfigurationElementCollection è stata modificata dopo l'ultimo salvataggio o caricamento quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
IsReadOnly()

Indica se l'oggetto ConfigurationElementCollection è di sola lettura.

(Ereditato da ConfigurationElementCollection)
ListErrors(IList)

Aggiunge gli errori di proprietà non validi in questo oggetto ConfigurationElement e in tutti i sottoelementi all'elenco passato.

(Ereditato da ConfigurationElement)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)

Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione.

(Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Fa sì che il sistema di configurazione generi un'eccezione.

(Ereditato da ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)

Genera un'eccezione quando non viene trovata una proprietà obbligatoria.

(Ereditato da ConfigurationElement)
PostDeserialize()

Chiamato dopo la deserializzazione.

(Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)

Chiamato prima della serializzazione.

(Ereditato da ConfigurationElement)
Remove(String)

Rimuove un ExpressionBuilder oggetto dall'insieme ExpressionBuilderCollection .

RemoveAt(Int32)

Rimuove un ExpressionBuilder oggetto dall'insieme ExpressionBuilderCollection .

Reset(ConfigurationElement)

Reimposta il ConfigurationElementCollection sullo stato non modificato quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
ResetModified()

Reimposta il valore della proprietà IsModified() su false quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)

Scrive i dati di configurazione in un elemento XML nel file di configurazione quando ne viene eseguito l'override in una classe derivata.

(Ereditato da ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)

Scrive i tag esterni di questo elemento di configurazione nel file di configurazione quando implementato 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 dell'unione delle informazioni di configurazione da diversi livelli della gerarchia di configurazione.

(Ereditato da ConfigurationElementCollection)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
ICollection.CopyTo(Array, Int32)

Copia il ConfigurationElementCollection in una matrice.

(Ereditato da ConfigurationElementCollection)

Metodi di estensione

Nome Descrizione
AsParallel(IEnumerable)

Abilita la parallelizzazione di una query.

AsQueryable(IEnumerable)

Converte un IEnumerable in un IQueryable.

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un IEnumerable al tipo specificato.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un IEnumerable in base a un tipo specificato.

Si applica a

Vedi anche