ConfigurationSectionWithCollection.Get 方法

从配置节中检索集合的指定成员。

语法

ConfigurationSectionWithCollection.Get   
   CollectionName,   
   ElementIdentifier,   
   CollectionElement;  

ConfigurationSectionWithCollection.Get   
CollectionName,   
ElementIdentifier,   
CollectionElement  

参数设置

名称	描述
CollectionName	一个 string 值，该值包含将检索的集合的名称（例如“Modules”）。 集合名称可以代表嵌套集合，也可以使用索引。 索引可以是从零开始的整数索引或字符串（例如 [9] 或“KeyProperty='Value'”）。 有关详细信息，请参阅“备注”部分。 注意：CollectionName 是配置文件中的节名称，而不是相应 WMI 类的名称（例如，是“Modules”，而不是“ModulesSection”）。
ElementIdentifier	一个 string 值，指定要检索的集合元素的键属性和值。 字符串的格式必须为“KeyProperty1='Value1',KeyProperty2='Value2',…”（例如“Name='RoleManager'”）。
CollectionElement	一个 CollectionElement 对象变量，检索到的集合元素将被放入该变量（例如 oModule）。

返回值

void。

注解

如果只想检索集合的一个成员，此方法非常有用。

以下示例演示 CollectionName 参数的语法变体。

以下语法显示了使用基于字符串的“KeyProperty='Value'”索引并指定嵌套集合的 CollectionName 参数：

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

可以使用从零开始的索引指定相同的值：

traceFailedRequests[1].TraceAreas.TraceAreas

如果 ElementIdentifier 参数为 "provider='ASP'"，CollectionElement 输出变量为 oTraceAreaElement，则 Get 方法的完整调用语法如下：

oSection.Get _

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

"provider='ASP'", oTraceAreaElement

以下语法显示了使用从零开始的索引的完整调用：

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  
  

要求

类型	描述
客户端	- IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上）
服务器	- IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上）
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

CollectionElement 类
ConfigurationSectionWithCollection 类
ModuleAction 类
ModulesSection 类
TraceAreaElement 类
TraceFailedRequestsSection 类
TraceUrl 类
TraceUrlAreaSettings 类