ExpressionBuilderCollection Klasse

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Auflistung von ExpressionBuilder -Objekten dar. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

ConfigurationElement

ConfigurationElementCollection
ExpressionBuilderCollection

Attribute: ConfigurationCollectionAttribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Beispiel wird veranschaulicht, wie Werte für mehrere Eigenschaften der ExpressionBuilderCollection Klasse deklarativ angegeben werden. Die zweite veranschaulicht die Verwendung von Membern der ExpressionBuilderCollection Klasse.

Das folgende Konfigurationsdateibeispiel zeigt, wie Werte für mehrere Eigenschaften der ExpressionBuilderCollection Klasse deklarativ angegeben werden.

<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>

Im folgenden Codebeispiel wird die Verwendung von Membern der ExpressionBuilderCollection Klasse veranschaulicht.

#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

Hinweise

Die ExpressionBuilderCollection Klasse verweist nicht auf ein tatsächliches Element in der zugrunde liegenden Konfigurationsdatei. Es ist ein Konstrukt, das einfachen Zugriff auf die darin enthaltenen Kompilierungsinformationen ermöglicht.

Konstruktoren

Name	Beschreibung
ExpressionBuilderCollection()	Initialisiert eine neue Instanz der ExpressionBuilderCollection-Klasse.

Eigenschaften

Name	Beschreibung
AddElementName	Dient zum Abrufen oder Festlegen des Namens des ConfigurationElement Add-Vorgangs, der dem Add-Vorgang in einer ConfigurationElementCollection abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
ClearElementName	Dient zum Abrufen oder Festlegen des Namens für den ConfigurationElement zuordnenden clear-Vorgang in der ConfigurationElementCollection Beim Außerkraftsetzung in einer abgeleiteten Klasse. (Geerbt von ConfigurationElementCollection)
CollectionType	Ruft den Typ der .ConfigurationElementCollection (Geerbt von ConfigurationElementCollection)
Count	Ruft die Anzahl der Elemente in der Auflistung ab. (Geerbt von ConfigurationElementCollection)
CurrentConfiguration	Ruft einen Verweis auf die Instanz der obersten Ebene Configuration, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement Instanz gehört. (Geerbt von ConfigurationElement)
ElementInformation	Ruft ein ElementInformation -Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement -Objekts enthält. (Geerbt von ConfigurationElement)
ElementName	Ruft den Namen ab, der verwendet wird, um diese Auflistung von Elementen in der Konfigurationsdatei zu identifizieren, wenn diese in einer abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
ElementProperty	Ruft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EmitClear	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Auflistung gelöscht wurde. (Geerbt von ConfigurationElementCollection)
EvaluationContext	Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Geerbt von ConfigurationElement)
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration -Eigenschaft `null`ist. (Geerbt von ConfigurationElement)
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert wird. (Geerbt von ConfigurationElementCollection)
Item[ConfigurationProperty]	Dient zum Abrufen oder Festlegen einer Eigenschaft oder eines Attributs dieses Konfigurationselements. (Geerbt von ConfigurationElement)
Item[Int32]	Ruft den ExpressionBuilder angegebenen Index in der Auflistung ab oder legt sie ExpressionBuilderCollection fest.
Item[String]	Ruft das ExpressionBuilder Objekt mit dem angegebenen Namen ab.
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element gesperrt ist. (Geerbt von ConfigurationElement)
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
RemoveElementName	Dient zum Abrufen oder Festlegen des Namens des ConfigurationElement zuzuordnenden Vorgangs zum Entfernen im ConfigurationElementCollection Zeitpunkt der Außerkraftsetzung in einer abgeleiteten Klasse. (Geerbt von ConfigurationElementCollection)
SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die ConfigurationElementCollection. (Geerbt von ConfigurationElementCollection)
ThrowOnDuplicate	Ruft einen Wert ab, der angibt, ob ein Versuch, einem Duplikat ConfigurationElement hinzuzufügen, ConfigurationElementCollection eine Ausnahme ausgelöst wird. (Geerbt von ConfigurationElementCollection)

Methoden

Name	Beschreibung
Add(ExpressionBuilder)	Fügt ein ExpressionBuilder ExpressionBuilderCollectionObjekt zum .
BaseAdd(ConfigurationElement, Boolean)	Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu. (Geerbt von ConfigurationElementCollection)
BaseAdd(ConfigurationElement)	Fügt dem ConfigurationElementCollection.-Element ein Konfigurationselement hinzu. (Geerbt von ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu. (Geerbt von ConfigurationElementCollection)
BaseClear()	Entfernt alle Konfigurationselementobjekte aus der Auflistung. (Geerbt von ConfigurationElementCollection)
BaseGet(Int32)	Ruft das Konfigurationselement am angegebenen Indexspeicherort ab. (Geerbt von ConfigurationElementCollection)
BaseGet(Object)	Gibt das Konfigurationselement mit dem angegebenen Schlüssel zurück. (Geerbt von ConfigurationElementCollection)
BaseGetAllKeys()	Gibt ein Array der Schlüssel für alle Konfigurationselemente zurück, die in der ConfigurationElementCollection. (Geerbt von ConfigurationElementCollection)
BaseGetKey(Int32)	Ruft den Schlüssel für den ConfigurationElement angegebenen Indexspeicherort ab. (Geerbt von ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Gibt den Index des angegebenen .ConfigurationElement (Geerbt von ConfigurationElementCollection)
BaseIsRemoved(Object)	Gibt an, ob der ConfigurationElement mit dem angegebenen Schlüssel aus dem ConfigurationElementCollection. (Geerbt von ConfigurationElementCollection)
BaseRemove(Object)	Entfernt eine ConfigurationElement Aus der Auflistung. (Geerbt von ConfigurationElementCollection)
BaseRemoveAt(Int32)	Entfernt den ConfigurationElement Angegebenen Indexspeicherort. (Geerbt von ConfigurationElementCollection)
Clear()	Löscht alle ExpressionBuilder Objekte aus der ExpressionBuilderCollection Auflistung.
CopyTo(ConfigurationElement[], Int32)	Kopiert den Inhalt des ConfigurationElementCollection Elements in ein Array. (Geerbt von ConfigurationElementCollection)
CreateNewElement()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein neues ConfigurationElementerstellt. (Geerbt von ConfigurationElementCollection)
CreateNewElement(String)	Erstellt eine neue ConfigurationElement , wenn sie in einer abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht das ConfigurationElementCollection angegebene Objekt. (Geerbt von ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Ruft den Elementschlüssel für ein angegebenes Konfigurationselement ab, wenn es in einer abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
GetEnumerator()	Ruft ein IEnumerator , das zum Durchlaufen der ConfigurationElementCollection. (Geerbt von ConfigurationElementCollection)
GetHashCode()	Ruft einen eindeutigen Wert ab, der die ConfigurationElementCollection Instanz darstellt. (Geerbt von ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt das ConfigurationElement-Objekt auf den Anfangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsElementName(String)	Gibt an, ob die angegebene ConfigurationElement in der ConfigurationElementCollection. (Geerbt von ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Gibt an, ob der angegebene ConfigurationElement Wert aus dem ConfigurationElementCollection. (Geerbt von ConfigurationElementCollection)
IsModified()	Gibt an, ob dies ConfigurationElementCollection seit dem letzten Speichern oder Laden geändert wurde, wenn sie in einer abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
IsReadOnly()	Gibt an, ob das ConfigurationElementCollection Objekt schreibgeschützt ist. (Geerbt von ConfigurationElementCollection)
ListErrors(IList)	Fügt der übergebenen Liste die Fehler der ungültigen Eigenschaft in diesem ConfigurationElement-Objekt und in allen Unterelementen hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut gefunden wird. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Bewirkt, dass das Konfigurationssystem eine Ausnahme auslöst. (Geerbt von ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Remove(String)	Entfernt ein ExpressionBuilder Objekt aus der ExpressionBuilderCollection Auflistung.
RemoveAt(Int32)	Entfernt ein ExpressionBuilder Objekt aus der ExpressionBuilderCollection Auflistung.
Reset(ConfigurationElement)	Setzt den ConfigurationElementCollection zustandslos zurück, wenn er in einer abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
ResetModified()	Setzt den Wert der IsModified() Eigenschaft zurück, wenn `false` sie in einer abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Schreibt die Konfigurationsdaten in ein XML-Element in der Konfigurationsdatei, wenn dies in einer abgeleiteten Klasse überschrieben wird. (Geerbt von ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetReadOnly()	Legt die IsReadOnly() Eigenschaft für das ConfigurationElementCollection Objekt und für alle Unterelemente fest. (Geerbt von ConfigurationElementCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Kehrt die Auswirkung des Zusammenführens von Konfigurationsinformationen aus verschiedenen Ebenen der Konfigurationshierarchie auf. (Geerbt von ConfigurationElementCollection)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ICollection.CopyTo(Array, Int32)	Kopiert das ConfigurationElementCollection Array in ein Array. (Geerbt von ConfigurationElementCollection)

Erweiterungsmethoden

Name	Beschreibung
AsParallel(IEnumerable)	Aktiviert die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Wandelt eine IEnumerable in eine IQueryableum.
Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.
OfType<TResult>(IEnumerable)	Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?