ConfigurationSectionWithCollection.Get-Methode

Artikel
03/25/2024

Ruft den angegebenen Member einer Auflistung aus einem Konfigurationsabschnitt ab.

Syntax

ConfigurationSectionWithCollection.Get   
   CollectionName,   
   ElementIdentifier,   
   CollectionElement;

ConfigurationSectionWithCollection.Get   
CollectionName,   
ElementIdentifier,   
CollectionElement

Parameter

Name	Beschreibung
`CollectionName`	Ein `string` Wert, der den Namen der Auflistung enthält, die abgerufen wird (z. B. "Modules"). Der Auflistungsname kann eine geschachtelte Auflistung darstellen und Indizes verwenden. Der Index kann entweder ein nullbasierter ganzzahliger Index oder eine Zeichenfolge sein (z. B. [9] oder "KeyProperty='Value'"). Weitere Informationen finden Sie im Abschnitt Hinweise. Hinweis: Dies `CollectionName` ist der Name des Abschnitts, wie er in der Konfigurationsdatei gefunden wird, nicht den Namen der entsprechenden WMI-Klasse (z. B. "Modules", nicht "ModulesSection").
`ElementIdentifier`	Ein `string` Wert, der eine Schlüsseleigenschaft und einen Wert des abzurufenden Sammlungselements angibt. Die Zeichenfolge muss im Format "KeyProperty1='Value1',KeyProperty2='Value2',..." vorliegen. (z. B. "Name='RoleManager'").
`CollectionElement`	Eine CollectionElement-Objektvariable , in die das abgerufene Auflistungselement eingefügt wird (z. B.`oModule`).

Rückgabewert

void.

Hinweise

Diese Methode ist nützlich, wenn Sie nur ein Element einer Auflistung abrufen möchten.

Die folgenden Beispiele veranschaulichen Syntaxvariationen für den CollectionName Parameter.

Die folgende Syntax zeigt einen CollectionName Parameter, der einen zeichenfolgenbasierten Index "KeyProperty='Value'" verwendet und eine geschachtelte Auflistung angibt:

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

Sie können denselben Wert mit einem nullbasierten Index angeben:

traceFailedRequests[1].TraceAreas.TraceAreas

Wenn der ElementIdentifier Parameter "provider='ASP'" und die CollectionElement Ausgabevariable oTraceAreaElement lautet, sieht der vollständige Aufruf der Get Methode möglicherweise wie die folgende Syntax aus:

oSection.Get _

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

"provider='ASP'", oTraceAreaElement

Die folgende Syntax zeigt den vollständigen Aufruf mit einem nullbasierten Index:

oSection.Get _

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

"provider='ASP'", oTraceAreaElement

Beispiel

Im folgenden Beispiel wird der Name und Typ des RoleManager Moduls aus dem <modules> Abschnitt der ApplicationHost.config-Datei abgerufen.

' 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

Anforderungen

type	Beschreibung
Client	IIS 7.0 unter Windows Vista. IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016.
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

CollectionElement-Klasse
ConfigurationSectionWithCollection-Klasse
ModuleAction-Klasse
ModulesSection-Klasse
TraceAreaElement-Klasse
TraceFailedRequestsSection-Klasse
TraceUrl-Klasse
TraceUrlAreaSettings-Klasse

Freigeben über