Поделиться через

Метод 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 для параметра .

В следующем синтаксисе CollectionName показан параметр, использующий строковый индекс KeyProperty='Value', и указывающий вложенную коллекцию:

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

Пример

В следующем примере имя и тип RoleManager модуля извлекаются из <modules> раздела файла ApplicationHost.config.

' 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