ConfigurationElement.GetCollection 方法

定義

命名空間:

Microsoft.Web.Administration

組件:

Microsoft.Web.Administration.dll

傳回屬於目前組態專案的所有組態專案。

多載

GetCollection(String, Type)	傳回具有指定名稱和類型的組態專案，且位於目前的組態專案之下。
GetCollection(Type)	傳回具有指定型別且位於目前組態專案底下的組態專案。
GetCollection(String)	傳回屬於目前組態專案的所有組態專案。
GetCollection()	傳回目前組態專案的預設集合。

GetCollection(String, Type)

傳回具有指定名稱和類型的組態專案，且位於目前的組態專案之下。

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

參數

collectionName

String

這個方法應該傳回的專案名稱。

collectionType

Type

Common Language Runtime (CLR) 型別的集合，這個方法應該傳回。

傳回

ConfigurationElement

ConfigurationElement 物件。

例外狀況

ArgumentNullException

collectionType 參數為 null。

備註

屬性中所 ChildElements 表示的子專案集合與方法傳回值所表示的 GetCollection 巢狀專案集合不同。 這兩個集合都包含 ConfigurationElement 物件。 不過，當您查詢組態時，應該使用 ChildElements 屬性來尋找唯一子項目，例如 system.webServer/asp 組態區段。 當您查詢包含唯一索引鍵或多重屬性索引鍵的集合元素組態時，應該使用 GetCollection 方法，例如組 system.webServer/sites 態區段

GetCollection(Type)

傳回具有指定型別且位於目前組態專案底下的組態專案。

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

參數

collectionType

Type

Common Language Runtime (CLR) 型別的集合，這個方法應該傳回。

傳回

ConfigurationElement

ConfigurationElement 物件。

例外狀況

ArgumentNullException

collectionType 參數是 null 或空白。

備註

屬性中所 ChildElements 表示的子專案集合與方法傳回值所表示的 GetCollection 巢狀專案集合不同。 這兩個集合都包含 ConfigurationElement 物件。 不過，當您查詢組態時，應該使用 ChildElements 屬性來尋找唯一子項目，例如 system.webServer/asp 組態區段。 當您查詢包含唯一索引鍵或多重屬性索引鍵的集合元素組態時，應該使用 GetCollection 方法，例如組 system.webServer/sites 態區段

GetCollection(String)

傳回屬於目前組態專案的所有組態專案。

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

參數

collectionName

String

這個方法應該傳回的集合名稱。

傳回

ConfigurationElementCollection

ConfigurationElementCollection 物件。

例外狀況

ArgumentNullException

collectionName 參數是 null 或空白。

GetCollection()

傳回目前組態專案的預設集合。

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

傳回

ConfigurationElementCollection

ConfigurationElementCollection物件，表示目前組態專案的預設集合。

備註

屬性中所 ChildElements 表示的子專案集合與方法傳回值所表示的 GetCollection 巢狀專案集合不同。 這兩個集合都包含 ConfigurationElement 物件。 不過，當您查詢組態時，應該使用 ChildElements 屬性來尋找唯一子項目，例如 system.webServer/asp 組態區段。 當您查詢包含唯一索引鍵或多重屬性索引鍵的集合元素組態時，應該使用 GetCollection 方法，例如組 system.webServer/sites 態區段。