(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

ExpressionBuilderCollection-Klasse

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

Namespace:  System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

[ConfigurationCollectionAttribute(typeof(ExpressionBuilder))]
public sealed class ExpressionBuilderCollection : ConfigurationElementCollection

Der ExpressionBuilderCollection-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeExpressionBuilderCollectionInitialisiert eine neue Instanz der ExpressionBuilderCollection-Klasse.
Zum Seitenanfang

  NameBeschreibung
Geschützte EigenschaftAddElementNameRuft den Namen des ConfigurationElement ab, das beim Überschreiben in einer abgeleiteten Klasse dem Hinzufügevorgang in der ConfigurationElementCollection zugeordnet werden soll, oder legt diesen fest. (Von ConfigurationElementCollection geerbt.)
Geschützte EigenschaftClearElementNameRuft den Namen für das ConfigurationElement ab, das beim Überschreiben in einer abgeleiteten Klasse dem Löschvorgang in der ConfigurationElementCollection zugeordnet werden soll, oder legt diesen fest. (Von ConfigurationElementCollection geerbt.)
Öffentliche EigenschaftCollectionTypeRuft den Typ der ConfigurationElementCollection ab. (Von ConfigurationElementCollection geerbt.)
Öffentliche EigenschaftCountRuft die Anzahl der Elemente in der Auflistung ab. (Von ConfigurationElementCollection geerbt.)
Öffentliche EigenschaftCurrentConfigurationRuft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftElementInformationRuft ein ElementInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement-Objekts enthält. (Von ConfigurationElement geerbt.)
Geschützte EigenschaftElementPropertyRuft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftEmitClearRuft einen Wert ab, der angibt, ob die Auflistung gelöscht wurde, oder legt diesen fest. (Von ConfigurationElementCollection geerbt.)
Öffentliche EigenschaftIsSynchronizedRuft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist. (Von ConfigurationElementCollection geerbt.)
Geschützte EigenschaftItem[ConfigurationProperty]Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftItem[Int32]Ruft den ExpressionBuilder am angegebenen Index in der ExpressionBuilderCollection-Auflistung ab oder legt diesen fest.
Öffentliche EigenschaftItem[String]Ruft das ExpressionBuilder-Objekt mit dem angegebenen Namen ab.
Öffentliche EigenschaftLockAllAttributesExceptRuft die Auflistung gesperrter Attribute ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockAllElementsExceptRuft die Auflistung gesperrter Elemente ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockAttributesRuft die Auflistung gesperrter Attribute ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockElementsRuft die Auflistung gesperrter Elemente ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockItemRuft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest. (Von ConfigurationElement geerbt.)
Geschützte EigenschaftPropertiesRuft die Auflistung von Eigenschaften ab. (Von ConfigurationElement geerbt.)
Geschützte EigenschaftRemoveElementNameRuft den Namen des ConfigurationElement ab, das beim Überschreiben in einer abgeleiteten Klasse dem Entfernungsvorgang in der ConfigurationElementCollection zugeordnet werden soll, oder legt diesen fest. (Von ConfigurationElementCollection geerbt.)
Öffentliche EigenschaftSyncRootRuft ein Objekt ab, das zum Synchronisieren des Zugriffs auf ConfigurationElementCollection verwendet wird. (Von ConfigurationElementCollection geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeAddFügt der ExpressionBuilderCollection ein ExpressionBuilder-Objekt hinzu.
Geschützte MethodeBaseAdd(ConfigurationElement, Boolean)Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseClearEntfernt alle Konfigurationselementobjekte aus der Auflistung. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseGet(Int32)Ruft das Konfigurationselement am angegebenen Index ab. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseGet(Object)Gibt das Konfigurationselement mit dem angegebenen Schlüssel zurück. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseGetAllKeysGibt ein Array der Schlüssel für alle Konfigurationselemente in der ConfigurationElementCollection zurück. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseGetKeyRuft den Schlüssel für das ConfigurationElement an der angegebenen Indexposition ab. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseIsRemovedGibt an, ob das ConfigurationElement mit dem angegebenen Schlüssel aus der ConfigurationElementCollection entfernt worden ist. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseRemoveEntfernt ein ConfigurationElement aus der Auflistung. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeBaseRemoveAtEntfernt das ConfigurationElement an der angegebenen Indexposition. (Von ConfigurationElementCollection geerbt.)
Öffentliche MethodeClearLöscht alle ExpressionBuilder-Objekte aus der ExpressionBuilderCollection-Auflistung.
Öffentliche MethodeCopyToKopiert den Inhalt der ConfigurationElementCollection in ein Array. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeDeserializeElementLiest XML aus der Konfigurationsdatei. (Von ConfigurationElement geerbt.)
Öffentliche MethodeEqualsVergleicht die ConfigurationElementCollection mit dem angegebenen Objekt. (Von ConfigurationElementCollection geerbt.)
Öffentliche MethodeGetEnumeratorInfrastruktur. Ruft einen IEnumerator ab, der zum Durchlaufen von ConfigurationElementCollection verwendet wird. (Von ConfigurationElementCollection geerbt.)
Öffentliche MethodeGetHashCodeRuft einen eindeutigen Wert ab, der die ConfigurationElementCollection-Instanz darstellt. (Von ConfigurationElementCollection geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeInitLegt für das ConfigurationElement-Objekt den Ausgangszustand fest. (Von ConfigurationElement geerbt.)
Geschützte MethodeInitializeDefaultWird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren. (Von ConfigurationElement geerbt.)
Geschützte MethodeIsModifiedGibt an, ob diese ConfigurationElementCollection geändert wurde, seit sie zuletzt gespeichert oder geladen wurde, wenn sie in einer abgeleiteten Klasse überschrieben wurde. (Von ConfigurationElementCollection geerbt.)
Öffentliche MethodeIsReadOnlyGibt an, ob das ConfigurationElementCollection-Objekt schreibgeschützt ist. (Von ConfigurationElementCollection geerbt.)
Öffentliche MethodeRemoveEntfernt ein ExpressionBuilder-Objekt aus der ExpressionBuilderCollection-Auflistung.
Öffentliche MethodeRemoveAtEntfernt ein ExpressionBuilder-Objekt aus der ExpressionBuilderCollection-Auflistung.
Geschützte MethodeResetSetzt die ConfigurationElementCollection auf ihren unveränderten Zustand zurück, wenn sie in einer abgeleiteten Klasse überschrieben wurde. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeResetModifiedSetzt den Wert der IsModified-Eigenschaft auf false zurück, wenn er in einer abgeleiteten Klasse überschrieben wurde. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeSerializeElementSchreibt die Konfigurationsdaten in ein XML-Element in der Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse überschrieben wurden. (Von ConfigurationElementCollection geerbt.)
Geschützte MethodeSerializeToXmlElementSchreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei. (Von ConfigurationElement geerbt.)
Geschützte MethodeSetReadOnlyInfrastruktur. Legt die IsReadOnly-Eigenschaft für das ConfigurationElementCollection-Objekt und alle Unterelemente fest. (Von ConfigurationElementCollection geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Geschützte MethodeUnmergeInfrastruktur. Kehrt die Auswirkungen der Zusammenführung von Konfigurationsinformationen aus verschiedenen Ebenen der Konfigurationshierarchie um. (Von ConfigurationElementCollection geerbt.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeICollection.CopyToKopiert das ConfigurationElementCollection in ein Array. (Von ConfigurationElementCollection geerbt.)
Zum Seitenanfang

Die ExpressionBuilderCollection-Eigenschaft verweist nicht auf ein vorhandenes Element in der zugrunde liegenden Konfigurationsdatei. Sie ist ein Konstrukt, das leichten Zugriff auf die darin enthaltenen Kompilierungsinformationen ermöglicht.

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Beispiel wird veranschaulicht, wie Werte für mehrere Eigenschaften der ExpressionBuilderCollection-Klasse deklarativ angegeben werden. Im zweiten Beispiel wird veranschaulicht, wie Member der ExpressionBuilderCollection-Klasse verwendet werden.

Im folgenden Beispiel für die Konfigurationsdatei wird die deklarative Angabe von Werten für mehrere Eigenschaften der ExpressionBuilderCollection-Klasse veranschaulicht.

<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();
    }
  }
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft