Método ConfigurationSectionWithCollection.Get
Recupera o membro especificado de uma coleção de uma seção de configuração.
Sintaxe
ConfigurationSectionWithCollection.Get
CollectionName,
ElementIdentifier,
CollectionElement;
ConfigurationSectionWithCollection.Get
CollectionName,
ElementIdentifier,
CollectionElement
Parâmetros
| Nome | Descrição |
|---|---|
CollectionName |
Um valor string contendo o nome da coleção que será recuperada (por exemplo, "Módulos"). O nome da coleção pode representar uma coleção aninhada e usar índices. O índice pode ser um índice inteiro baseado em zero ou uma cadeia de caracteres (por exemplo, [9] ou "KeyProperty='Value'"). Para obter mais informações, consulte a seção Comentários. Anotação: o CollectionName é o nome da seção encontrada no arquivo de configuração, não o nome da classe WMI correspondente (por exemplo, "Modules", não "ModulesSection"). |
ElementIdentifier |
Um valor string que especifica uma propriedade de chave e um valor do elemento de coleção a ser recuperado. A cadeia de caracteres deve estar no formato "KeyProperty1='Value1',KeyProperty2='Value2',..." (por exemplo, "Name='RoleManager'"). |
CollectionElement |
Uma variável de objeto CollectionElement na qual o elemento de coleção recuperado será colocado (por exemplo, oModule). |
Valor de retorno
void.
Comentários
Esse método será útil quando você desejar recuperar apenas um membro de uma coleção.
Os exemplos a seguir demonstram as variações de sintaxe para o parâmetro CollectionName.
A sintaxe a seguir mostra um parâmetro CollectionName que usa um índice "KeyProperty='Value'" baseado em cadeia de caracteres e especifica uma coleção aninhada:
traceFailedRequests[path='Rule_2'].TraceAreas.TraceAreas
É possível especificar o mesmo valor com um índice baseado em zero:
traceFailedRequests[1].TraceAreas.TraceAreas
Se o parâmetro ElementIdentifier for "provider='ASP'" e a variável CollectionElement de saída for oTraceAreaElement, a chamada completa para o método Get poderá ser parecer com a seguinte sintaxe:
oSection.Get _
"traceFailedRequests[path='Rule_2'].TraceAreas.TraceAreas", _
"provider='ASP'", oTraceAreaElement
A sintaxe a seguir mostra a chamada completa com um índice baseado em zero:
oSection.Get _
"traceFailedRequests[1].TraceAreas.TraceAreas", _
"provider='ASP'", oTraceAreaElement
Exemplo
O exemplo a seguir recupera o nome e o tipo do módulo RoleManager da seção <modules> do arquivo 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
Requisitos
| Tipo | Descrição |
|---|---|
| Cliente | – IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10 |
| Servidor | – IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016 |
| Product | – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Arquivo MOF | WebAdministration.mof |
Confira também
Classe CollectionElement
Classe ConfigurationSectionWithCollection
Classe ModuleAction
Classe ModulesSection
Classe TraceAreaElement
Classe TraceFailedRequestsSection
Classe TraceUrl
Classe TraceUrlAreaSettings