ConfigurationElement.GetCollection Methode

Definition

Namespace:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Gibt alle Konfigurationselemente zurück, die zum aktuellen Konfigurationselement gehören.

Überlädt

GetCollection(String, Type)	Gibt das Konfigurationselement zurück, das den angegebenen Namen und Typ aufweist und sich unter dem aktuellen Konfigurationselement befindet.
GetCollection(Type)	Gibt das Konfigurationselement zurück, das über den angegebenen Typ verfügt und sich unter dem aktuellen Konfigurationselement befindet.
GetCollection(String)	Gibt alle Konfigurationselemente zurück, die zum aktuellen Konfigurationselement gehören.
GetCollection()	Gibt die Standardauflistung für das aktuelle Konfigurationselement zurück.

GetCollection(String, Type)

Gibt das Konfigurationselement zurück, das den angegebenen Namen und Typ aufweist und sich unter dem aktuellen Konfigurationselement befindet.

public:
 Microsoft::Web::Administration::ConfigurationElement ^ GetCollection(System::String ^ collectionName, Type ^ collectionType);

public Microsoft.Web.Administration.ConfigurationElement GetCollection (string collectionName, Type collectionType);

member this.GetCollection : string * Type -> Microsoft.Web.Administration.ConfigurationElement

Public Function GetCollection (collectionName As String, collectionType As Type) As ConfigurationElement

Parameter

collectionName

String

Der Name des Elements, das von dieser Methode zurückgegeben werden soll.

collectionType

Type

Der CLR-Typ (Common Language Runtime) der Auflistung, die von dieser Methode zurückgegeben werden soll.

Gibt zurück

ConfigurationElement

Ein ConfigurationElement-Objekt.

Ausnahmen

ArgumentNullException

Der collectionType-Parameter ist null.

Hinweise

Eine untergeordnete Elementauflistung, die in der ChildElements -Eigenschaft dargestellt wird, unterscheidet sich von einer geschachtelten Elementauflistung, die durch den Rückgabewert der GetCollection -Methode dargestellt wird. Beide Auflistungen enthalten ConfigurationElement Objekte. Sie sollten jedoch die ChildElements -Eigenschaft verwenden, wenn Sie die Konfiguration nach eindeutigen untergeordneten Elementen wie dem system.webServer/asp Konfigurationsabschnitt abfragen. Sie sollten die GetCollection -Methode verwenden, wenn Sie die Konfiguration für Sammlungselemente abfragen, die einen eindeutigen Schlüssel oder einen Schlüssel mit mehreren Attributen enthalten, z. B. den system.webServer/sites Konfigurationsabschnitt.

GetCollection(Type)

Gibt das Konfigurationselement zurück, das über den angegebenen Typ verfügt und sich unter dem aktuellen Konfigurationselement befindet.

public:
 Microsoft::Web::Administration::ConfigurationElement ^ GetCollection(Type ^ collectionType);

public Microsoft.Web.Administration.ConfigurationElement GetCollection (Type collectionType);

member this.GetCollection : Type -> Microsoft.Web.Administration.ConfigurationElement

Public Function GetCollection (collectionType As Type) As ConfigurationElement

Parameter

collectionType

Type

Der CLR-Typ (Common Language Runtime) der Auflistung, die von dieser Methode zurückgegeben werden soll.

Gibt zurück

ConfigurationElement

Ein ConfigurationElement-Objekt.

Ausnahmen

ArgumentNullException

Der collectionType-Parameter ist null oder leer.

Hinweise

Eine untergeordnete Elementauflistung, die in der ChildElements -Eigenschaft dargestellt wird, unterscheidet sich von einer geschachtelten Elementauflistung, die durch den Rückgabewert der GetCollection -Methode dargestellt wird. Beide Auflistungen enthalten ConfigurationElement Objekte. Sie sollten jedoch die ChildElements -Eigenschaft verwenden, wenn Sie die Konfiguration nach eindeutigen untergeordneten Elementen wie dem system.webServer/asp Konfigurationsabschnitt abfragen. Sie sollten die GetCollection -Methode verwenden, wenn Sie die Konfiguration für Sammlungselemente abfragen, die einen eindeutigen Schlüssel oder einen Schlüssel mit mehreren Attributen enthalten, z. B. den system.webServer/sites Konfigurationsabschnitt.

GetCollection(String)

Gibt alle Konfigurationselemente zurück, die zum aktuellen Konfigurationselement gehören.

public:
 Microsoft::Web::Administration::ConfigurationElementCollection ^ GetCollection(System::String ^ collectionName);

public Microsoft.Web.Administration.ConfigurationElementCollection GetCollection (string collectionName);

member this.GetCollection : string -> Microsoft.Web.Administration.ConfigurationElementCollection

Public Function GetCollection (collectionName As String) As ConfigurationElementCollection

Parameter

collectionName

String

Der Name der Auflistung, die von dieser Methode zurückgegeben werden soll.

Gibt zurück

ConfigurationElementCollection

Ein ConfigurationElementCollection-Objekt.

Ausnahmen

ArgumentNullException

Der collectionName-Parameter ist null oder leer.

GetCollection()

Gibt die Standardauflistung für das aktuelle Konfigurationselement zurück.

public:
 Microsoft::Web::Administration::ConfigurationElementCollection ^ GetCollection();

public Microsoft.Web.Administration.ConfigurationElementCollection GetCollection ();

member this.GetCollection : unit -> Microsoft.Web.Administration.ConfigurationElementCollection

Public Function GetCollection () As ConfigurationElementCollection

Gibt zurück

ConfigurationElementCollection

Ein ConfigurationElementCollection -Objekt, das die Standardauflistung für das aktuelle Konfigurationselement darstellt.

Hinweise

Eine untergeordnete Elementauflistung, die in der ChildElements -Eigenschaft dargestellt wird, unterscheidet sich von einer geschachtelten Elementauflistung, die durch den Rückgabewert der GetCollection -Methode dargestellt wird. Beide Auflistungen enthalten ConfigurationElement Objekte. Sie sollten jedoch die ChildElements -Eigenschaft verwenden, wenn Sie die Konfiguration nach eindeutigen untergeordneten Elementen wie dem system.webServer/asp Konfigurationsabschnitt abfragen. Sie sollten die GetCollection -Methode verwenden, wenn Sie die Konfiguration für Sammlungselemente abfragen, die einen eindeutigen Schlüssel oder einen Schlüssel mit mehreren Attributen enthalten, z. B. den system.webServer/sites Konfigurationsabschnitt.