ConfigurationSectionWithCollection.Get メソッド

構成セクションからコレクションの指定したメンバーを取得します。

構文

ConfigurationSectionWithCollection.Get   
   CollectionName,   
   ElementIdentifier,   
   CollectionElement;  

ConfigurationSectionWithCollection.Get   
CollectionName,   
ElementIdentifier,   
CollectionElement  

Parameters

戻り値

void=

解説

このメソッドは、コレクションのメンバーを 1 つだけ取得する場合に便利です。

次の例では、CollectionName パラメーターの構文のバリエーションを示します。

次の構文は、文字列ベースの "KeyProperty='Value'" インデックスを使用し、入れ子にしたコレクションを指定する CollectionName パラメーターを示しています。

traceFailedRequests[path='Rule_2'].TraceAreas.TraceAreas

同じ値を 0 から始まるインデックスで指定できます。

traceFailedRequests[1].TraceAreas.TraceAreas

ElementIdentifier パラメーターが "provider='ASP'" で、CollectionElement 出力変数が oTraceAreaElement である場合、Get メソッドの完全な呼び出しは次の構文のようになります。

oSection.Get _

"traceFailedRequests[path='Rule_2'].TraceAreas.TraceAreas", _

"provider='ASP'", oTraceAreaElement

次の構文では、0 から始まるインデックスを使用した完全な呼び出しを示しています。

oSection.Get _

"traceFailedRequests[1].TraceAreas.TraceAreas", _

"provider='ASP'", oTraceAreaElement

例

次の例では、ApplicationHost.config ファイルの <modules> セクションから RoleManager モジュールの名前と型を取得します。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' First, get the <modules> section by using the inherited   
' WMI Get method on the WMI class name of the section  
' (that is, "ModulesSection").  
Set oSection = oWebAdmin.Get( _  
    "ModulesSection.Path='MACHINE/WEBROOT/APPHOST/'," & _  
    "Location=''")  
  
' Display the path.   
WScript.Echo "Path: " & oSection.Path_.RelPath  
  
' Retrieve the RoleManager member of the collection.  
' This is the ConfigurationSectionWithCollection.Get method,  
' so use the collection name found in the configuration file  
' (that is, "Modules").  
oSection.Get "Modules", "Name='RoleManager'", oModule  
  
' Display the module name and type.  
WScript.Echo "Module Name: " & oModule.Name  
WScript.Echo "Module Type: " & oModule.Type  
  
' Output:  
' Path: ModulesSection.Location="",Path="MACHINE/WEBROOT/APPHOST/"  
' Module Name: RoleManager  
' Module Type: System.Web.Security.RoleManagerModule  
  

要件

参照

CollectionElement クラス
ConfigurationSectionWithCollection クラス
ModuleAction クラス
ModulesSection クラス
TraceAreaElement クラス
TraceFailedRequestsSection クラス
TraceUrl クラス
TraceUrlAreaSettings クラス