Homepage Library Lernen Code-Beispiele Downloads Support Community Foren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ConfigurationElementCollection-Klasse

.NET Framework 4.5

Stellt ein Konfigurationselement dar, das eine Auflistung der untergeordneten Elemente enthält.

System.Object
  System.Configuration.ConfigurationElement
    System.Configuration.ConfigurationElementCollection
      Weitere Informationen...

Namespace:  System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)
C#
C++
F#
VB
Kopieren 
public abstract class ConfigurationElementCollection : ConfigurationElement, 
	ICollection, IEnumerable

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

  NameBeschreibung
Geschützte MethodeConfigurationElementCollection()Initialisiert eine neue Instanz der ConfigurationElementCollection-Klasse.
Geschützte MethodeConfigurationElementCollection(IComparer)Erstellt eine neue Instanz der ConfigurationElementCollection-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.
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.
Öffentliche EigenschaftCollectionTypeRuft den Typ des ConfigurationElementCollection ab.
Öffentliche EigenschaftCountRuft die Anzahl der Elemente in der Auflistung ab.
Ö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 EigenschaftElementNameRuft den Namen ab, der beim Überschreiben in einer abgeleiteten Klasse für die Identifikation dieser Auflistung mit Elementen in der Konfigurationsdatei verwendet wird.
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.
Geschützte EigenschaftEvaluationContextRuft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Von ConfigurationElement geerbt.)
Geschützte EigenschaftHasContextRuft einen Wert ab, der angibt, ob die CurrentConfiguration-Eigenschaft nullist. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftIsSynchronizedRuft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist.
Geschützte EigenschaftItem[ConfigurationProperty]Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest. (Von ConfigurationElement geerbt.)
Geschützte EigenschaftItem[String]Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese(s) fest. (Von ConfigurationElement geerbt.)
Ö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.
Öffentliche EigenschaftSyncRootRuft ein Objekt ab, das zum Synchronisieren des Zugriffs auf ConfigurationElementCollection verwendet wird.
Geschützte EigenschaftThrowOnDuplicateRuft einen Wert ab, der angibt, ob der Versuch, der ConfigurationElementCollection ein doppeltes ConfigurationElement hinzuzufügen, eine Ausnahme auslöst.
Zum Seitenanfang
  NameBeschreibung
Geschützte MethodeBaseAdd(ConfigurationElement)Fügt der ConfigurationElementCollection ein Konfigurationselement hinzu.
Geschützte MethodeBaseAdd(ConfigurationElement, Boolean)Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu.
Geschützte MethodeBaseAdd(Int32, ConfigurationElement)Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu.
Geschützte MethodeBaseClearEntfernt alle Konfigurationselementobjekte aus der Auflistung.
Geschützte MethodeBaseGet(Int32)Ruft das Konfigurationselement am angegebenen Index ab.
Geschützte MethodeBaseGet(Object)Gibt das Konfigurationselement mit dem angegebenen Schlüssel zurück.
Geschützte MethodeBaseGetAllKeysGibt ein Array der Schlüssel für alle Konfigurationselemente in der ConfigurationElementCollection zurück.
Geschützte MethodeBaseGetKeyRuft den Schlüssel für das ConfigurationElement an der angegebenen Indexposition ab.
Geschützte MethodeBaseIndexOfGibt den Index der angegebenen ConfigurationElement an.
Geschützte MethodeBaseIsRemovedGibt an, ob das ConfigurationElement mit dem angegebenen Schlüssel aus der ConfigurationElementCollection entfernt worden ist.
Geschützte MethodeBaseRemoveEntfernt ein ConfigurationElement aus der Auflistung.
Geschützte MethodeBaseRemoveAtEntfernt das ConfigurationElement an der angegebenen Indexposition.
Öffentliche MethodeCopyToKopiert den Inhalt der ConfigurationElementCollection in ein Array.
Geschützte MethodeCreateNewElement()Erstellt beim Überschreiben in einer abgeleiteten Klasse einen neuen ConfigurationElement.
Geschützte MethodeCreateNewElement(String)Erstellt ein neues ConfigurationElement, wenn es in einer abgeleiteten Klasse überschrieben wurde.
Geschützte MethodeDeserializeElementLiest XML aus der Konfigurationsdatei. (Von ConfigurationElement geerbt.)
Öffentliche MethodeEqualsVergleicht die ConfigurationElementCollection mit dem angegebenen Objekt. (Überschreibt ConfigurationElement.Equals(Object).)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Geschützte MethodeGetElementKeyRuft beim Überschreiben in einer abgeleiteten Klasse den Elementschlüssel für ein angegebenes Konfigurationselement ab.
Öffentliche MethodeGetEnumeratorInfrastruktur. Ruft einen IEnumerator ab, der zum Durchlaufen von ConfigurationElementCollection verwendet wird.
Öffentliche MethodeGetHashCodeRuft einen eindeutigen Wert ab, der die ConfigurationElementCollection-Instanz darstellt. (Überschreibt ConfigurationElement.GetHashCode().)
Geschützte MethodeGetTransformedAssemblyStringGibt die transformierte Version des angegebenen Assemblynamens zurück. (Von ConfigurationElement geerbt.)
Geschützte MethodeGetTransformedTypeStringGibt die transformierte Version des angegebenen Typnamens zurück. (Von ConfigurationElement 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 MethodeIsElementNameGibt an, ob das angegebene ConfigurationElement in der ConfigurationElementCollection vorhanden ist.
Geschützte MethodeIsElementRemovableGibt an, ob das angegebene ConfigurationElement aus der ConfigurationElementCollection entfernt werden kann.
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. (Überschreibt ConfigurationElement.IsModified().)
Öffentliche MethodeIsReadOnlyGibt an, ob das ConfigurationElementCollection-Objekt schreibgeschützt ist. (Überschreibt ConfigurationElement.IsReadOnly().)
Geschützte MethodeListErrorsFügt die Fehler über ungültige Eigenschaften in diesem ConfigurationElement-Objekt und in allen Unterelementen der übergebenen Liste hinzu. (Von ConfigurationElement geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeOnDeserializeUnrecognizedAttributeRuft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut aufgetreten ist. (Von ConfigurationElement geerbt.)
Geschützte MethodeOnDeserializeUnrecognizedElementBewirkt, dass das Konfigurationssystem eine Ausnahme auslöst. (Überschreibt ConfigurationElement.OnDeserializeUnrecognizedElement(String, XmlReader).)
Geschützte MethodeOnRequiredPropertyNotFoundLöst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Von ConfigurationElement geerbt.)
Geschützte MethodePostDeserializeWird nach der Deserialisierung aufgerufen. (Von ConfigurationElement geerbt.)
Geschützte MethodePreSerializeWird vor der Serialisierung aufgerufen. (Von ConfigurationElement geerbt.)
Geschützte MethodeResetSetzt die ConfigurationElementCollection auf ihren unveränderten Zustand zurück, wenn sie in einer abgeleiteten Klasse überschrieben wurde. (Überschreibt ConfigurationElement.Reset(ConfigurationElement).)
Geschützte MethodeResetModifiedSetzt den Wert der IsModified-Eigenschaft auf false zurück, wenn er in einer abgeleiteten Klasse überschrieben wurde. (Überschreibt ConfigurationElement.ResetModified().)
Geschützte MethodeSerializeElementSchreibt die Konfigurationsdaten in ein XML-Element in der Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse überschrieben wurden. (Überschreibt ConfigurationElement.SerializeElement(XmlWriter, Boolean).)
Geschützte MethodeSerializeToXmlElementSchreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei. (Von ConfigurationElement geerbt.)
Geschützte MethodeSetPropertyValueLegt eine Eigenschaft auf den angegebenen Wert fest. (Von ConfigurationElement geerbt.)
Geschützte MethodeSetReadOnlyInfrastruktur. Legt die IsReadOnly-Eigenschaft für das ConfigurationElementCollection-Objekt und alle Unterelemente fest. (Überschreibt ConfigurationElement.SetReadOnly().)
Ö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. (Überschreibt ConfigurationElement.Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode).)
Zum Seitenanfang
  NameBeschreibung
Öffentliche ErweiterungsmethodeAsParallelErmöglicht die Parallelisierung einer Abfrage. (Durch ParallelEnumerable definiert.)
Öffentliche ErweiterungsmethodeAsQueryableKonvertiert ein IEnumerable in ein IQueryable. (Durch Queryable definiert.)
Öffentliche ErweiterungsmethodeCast<TResult>Wandelt das die Elemente aus IEnumerable in den angegebenen Typ. (Durch Enumerable definiert.)
Öffentliche ErweiterungsmethodeOfType<TResult>Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs. (Durch Enumerable definiert.)
Zum Seitenanfang
  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeICollection.CopyToKopiert die ConfigurationElementCollection in ein Array.
Zum Seitenanfang

Die ConfigurationElementCollection stellt innerhalb einer Konfigurationsdatei eine Auflistung der Elemente dar.

HinweisHinweis

Ein Element innerhalb einer Konfigurationsdatei verweist auf ein grundlegendes XML-Element oder einen Abschnitt. Ein einfaches Element ist ein XML-Tag mit zugehörigen Attributen, sofern vorhanden. Ein einfaches Element bildet einen Abschnitt. Komplexe Abschnitte können ein oder mehrere einfache Elemente, eine Auflistung von Elementen und andere Abschnitte enthalten.

Sie verwenden die ConfigurationElementCollection, um mit einer Auflistung der ConfigurationElement-Objekte zu arbeiten. Implementieren Sie diese Klasse, um Auflistungen von benutzerdefinierten ConfigurationElement-Elementen zu einem ConfigurationSection hinzuzufügen.

Hinweise zur Implementierung

Sie können ein programmgesteuertes oder deklaratives (attributiertes) Codierungsmodell zum Erstellen eines benutzerdefinierten Konfigurationselements verwenden.

Für das programmgesteuerte Modell ist es erforderlich, dass Sie für jedes Elementattribut eine Eigenschaft erstellen, um seinen Wert abzurufen und festzulegen und ihn der internen Eigenschaftensammlung der zugrunde liegenden ConfigurationElement-Basisklasse hinzufügen.

Mit dem deklarativen Modell, das auch attributiertes Modell genannt wird, können Sie ein Elementattribut durch die Verwendung einer Eigenschaft und ihre Konfiguration mit Attributen definieren. Diese Attribute informieren das ASP.NET-Konfigurationssystem über die Eigenschaftentypen und ihre Standardwerte. ASP.NET kann Reflektion verwenden, um diese Informationen zu erhalten, und kann dann die Elementeigenschaftenobjekte erstellen und die erforderliche Initialisierung ausführen.

Im folgenden Beispiel wird die Verwendung von ConfigurationCollectionElement veranschaulicht.

Das erste Beispiel besteht aus drei Klassen: UrlsSection, UrlsCollection und UrlConfigElement. Die UrlsSection-Klasse definiert mithilfe des ConfigurationCollectionAttribute einen benutzerdefinierten Konfigurationabschnitt. Dieser Abschnitt enthält eine URL-Auflistung (von der UrlsCollection-Klasse definiert) von URL-Elementen (von der UrlConfigElement-Klasse definiert).

In diesem zweiten Codebeispiel werden die vorher angegebenen Klassen verwendet. Sie kombinieren diese zwei Beispiele in einem Konsolenanwendungsprojekt.

Wenn Sie die Konsolenanwendung ausführen, wird eine Instanz der UrlsSection-Klasse erstellt, und die folgenden Konfigurationselemente werden in der Anwendungskonfigurationsdatei generiert:

Kopieren 
<configuration>
    <configSections>
        <section name="MyUrls" type="UrlsSection, 
          ConfigurationElementCollection, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
    </configSections>
    <MyUrls>
        <urls>
           <add name="Contoso" url="http://www.contoso.com" port="4040 />
        </urls>
    </MyUrls>
</configuration

.NET Framework

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

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

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)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. 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.
System.Object
  System.Configuration.ConfigurationElement
    System.Configuration.ConfigurationElementCollection
      System.Configuration.ConnectionStringSettingsCollection
      System.Configuration.KeyValueConfigurationCollection
      System.Configuration.NameValueConfigurationCollection
      System.Configuration.ProviderSettingsCollection
      System.Configuration.SchemeSettingElementCollection
      System.Configuration.SettingElementCollection
      System.IdentityModel.Configuration.AudienceUriElementCollection
      System.IdentityModel.Configuration.IdentityConfigurationElementCollection
      System.IdentityModel.Configuration.SecurityTokenHandlerElementCollection
      System.IdentityModel.Configuration.SecurityTokenHandlerSetElementCollection
      System.IdentityModel.Services.Configuration.FederationConfigurationElementCollection
      System.Net.Configuration.AuthenticationModuleElementCollection
      System.Net.Configuration.BypassElementCollection
      System.Net.Configuration.ConnectionManagementElementCollection
      System.Net.Configuration.WebRequestModuleElementCollection
      System.Runtime.Caching.Configuration.MemoryCacheSettingsCollection
      System.Runtime.Serialization.Configuration.DeclaredTypeElementCollection
      System.Runtime.Serialization.Configuration.ParameterElementCollection
      System.Runtime.Serialization.Configuration.TypeElementCollection
      System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElementCollection
      System.ServiceModel.Activities.Tracking.Configuration.TrackingConfigurationCollection<TConfigurationElement>
      System.ServiceModel.Configuration.ServiceModelConfigurationElementCollection<ConfigurationElementType>
      System.ServiceModel.Routing.Configuration.BackupEndpointCollection
      System.ServiceModel.Routing.Configuration.BackupListCollection
      System.ServiceModel.Routing.Configuration.FilterElementCollection
      System.ServiceModel.Routing.Configuration.FilterTableCollection
      System.ServiceModel.Routing.Configuration.FilterTableEntryCollection
      System.ServiceModel.Routing.Configuration.NamespaceElementCollection
      System.Web.Configuration.AssemblyCollection
      System.Web.Configuration.AuthorizationRuleCollection
      System.Web.Configuration.BufferModesCollection
      System.Web.Configuration.BuildProviderCollection
      System.Web.Configuration.ClientTargetCollection
      System.Web.Configuration.CodeSubDirectoriesCollection
      System.Web.Configuration.CompilerCollection
      System.Web.Configuration.ConvertersCollection
      System.Web.Configuration.CustomErrorCollection
      System.Web.Configuration.EventMappingSettingsCollection
      System.Web.Configuration.ExpressionBuilderCollection
      System.Web.Configuration.FolderLevelBuildProviderCollection
      System.Web.Configuration.FormsAuthenticationUserCollection
      System.Web.Configuration.FullTrustAssemblyCollection
      System.Web.Configuration.HttpHandlerActionCollection
      System.Web.Configuration.HttpModuleActionCollection
      System.Web.Configuration.IgnoreDeviceFilterElementCollection
      System.Web.Configuration.NamespaceCollection
      System.Web.Configuration.OutputCacheProfileCollection
      System.Web.Configuration.PartialTrustVisibleAssemblyCollection
      System.Web.Configuration.ProfileGroupSettingsCollection
      System.Web.Configuration.ProfilePropertySettingsCollection
      System.Web.Configuration.ProfileSettingsCollection
      System.Web.Configuration.ProtocolCollection
      System.Web.Configuration.RuleSettingsCollection
      System.Web.Configuration.SqlCacheDependencyDatabaseCollection
      System.Web.Configuration.TagMapCollection
      System.Web.Configuration.TagPrefixCollection
      System.Web.Configuration.TransformerInfoCollection
      System.Web.Configuration.TrustLevelCollection
      System.Web.Configuration.UrlMappingCollection
      System.Web.Mobile.DeviceFilterElementCollection
      System.Web.Services.Configuration.ProtocolElementCollection
      System.Web.Services.Configuration.SoapExtensionTypeElementCollection
      System.Web.Services.Configuration.TypeElementCollection
      System.Web.Services.Configuration.WsiProfilesElementCollection
      System.Web.UI.MobileControls.ControlElementCollection
      System.Web.UI.MobileControls.DeviceElementCollection
      System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElementCollection
      System.Xaml.Hosting.Configuration.HandlerElementCollection
      System.Xml.Serialization.Configuration.SchemaImporterExtensionElementCollection
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.