EnumerationOptions-Konstruktor (ManagementNamedValueCollection, TimeSpan, Int32, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean)

Initialisiert eine neue Instanz der EnumerationOptions-Klasse, die für Abfragen oder Enumerationen zu verwenden ist und dem Benutzer die Möglichkeit gibt, Werte für die verschiedenen Optionen anzugeben.

Namespace: System.Management
Assembly: System.Management (in system.management.dll)

Syntax

'Declaration
Public Sub New ( _
    context As ManagementNamedValueCollection, _
    timeout As TimeSpan, _
    blockSize As Integer, _
    rewindable As Boolean, _
    returnImmediatley As Boolean, _
    useAmendedQualifiers As Boolean, _
    ensureLocatable As Boolean, _
    prototypeOnly As Boolean, _
    directRead As Boolean, _
    enumerateDeep As Boolean _
)
'Usage
Dim context As ManagementNamedValueCollection
Dim timeout As TimeSpan
Dim blockSize As Integer
Dim rewindable As Boolean
Dim returnImmediatley As Boolean
Dim useAmendedQualifiers As Boolean
Dim ensureLocatable As Boolean
Dim prototypeOnly As Boolean
Dim directRead As Boolean
Dim enumerateDeep As Boolean

Dim instance As New EnumerationOptions(context, timeout, blockSize, rewindable, returnImmediatley, useAmendedQualifiers, ensureLocatable, prototypeOnly, directRead, enumerateDeep)

public EnumerationOptions (
    ManagementNamedValueCollection context,
    TimeSpan timeout,
    int blockSize,
    bool rewindable,
    bool returnImmediatley,
    bool useAmendedQualifiers,
    bool ensureLocatable,
    bool prototypeOnly,
    bool directRead,
    bool enumerateDeep
)

public:
EnumerationOptions (
    ManagementNamedValueCollection^ context, 
    TimeSpan timeout, 
    int blockSize, 
    bool rewindable, 
    bool returnImmediatley, 
    bool useAmendedQualifiers, 
    bool ensureLocatable, 
    bool prototypeOnly, 
    bool directRead, 
    bool enumerateDeep
)

public EnumerationOptions (
    ManagementNamedValueCollection context, 
    TimeSpan timeout, 
    int blockSize, 
    boolean rewindable, 
    boolean returnImmediatley, 
    boolean useAmendedQualifiers, 
    boolean ensureLocatable, 
    boolean prototypeOnly, 
    boolean directRead, 
    boolean enumerateDeep
)

public function EnumerationOptions (
    context : ManagementNamedValueCollection, 
    timeout : TimeSpan, 
    blockSize : int, 
    rewindable : boolean, 
    returnImmediatley : boolean, 
    useAmendedQualifiers : boolean, 
    ensureLocatable : boolean, 
    prototypeOnly : boolean, 
    directRead : boolean, 
    enumerateDeep : boolean
)

Parameter

• context
  Das Kontextobjekt für die Optionen mit den providerspezifischen Informationen, die an den Provider übergeben werden können.

• timeout
  Der Timeoutwert für die Enumeration der Ergebnisse.

• blockSize
  Die Anzahl der gleichzeitig aus WMI abzurufenden Elemente.

• rewindable
  true, um anzuzeigen, dass das Ergebnis rücklauffähig ist (ermöglicht mehrere Durchläufe), andernfalls false.

• returnImmediatley
  true, um anzuzeigen, dass die Operation sofort zurückgeben soll (halbsynchron). false, wenn die Operation blockieren soll, bis alle Ergebnisse verfügbar sind.

• useAmendedQualifiers
  true, um anzuzeigen, dass die zurückgegebenen Objekte ergänzende (gebietsschemabezogene) Qualifizierer enthalten sollen, andernfalls false.

• ensureLocatable
  true, um sicherzustellen, dass alle zurückgegebenen Objekte über gültige Pfade verfügen, andernfalls false.

• prototypeOnly
  true, wenn anstelle der eigentlichen Ergebnisse ein Prototyp des Resultsets zurückgegeben werden soll, andernfalls false.

• directRead
  true, wenn ausschließlich Objekte der angegebenen Klasse oder auch von abgeleiteten Klassen abgerufen werden sollen, andernfalls false.

• enumerateDeep
  true, um rekursive Enumerationen für untergeordnete Klassen zu verwenden, andernfalls false.

Beispiel

Im folgenden Beispiel wird eine EnumerationOptions-Variable mit einem EnumerationOptions-Konstruktor initialisiert. Daraufhin werden alle Instanzen einer WMI-Klasse und ihrer Unterklassen abgerufen.

Imports System
Imports System.Management
Public Class RemoteConnect

    Public Overloads Shared Function Main( _
    ByVal args() As String) As Integer

        Dim opt As EnumerationOptions
        Opt = New EnumerationOptions( _
            Nothing, System.TimeSpan.MaxValue, _
            1, True, True, False, _
            True, False, False, True)

        Dim mngmtClass As New ManagementClass("CIM_Service")
        Dim o As ManagementObject
        For Each o In mngmtClass.GetInstances(opt)
            Console.WriteLine(o("Name"))
        Next o

        Return 0
    End Function
End Class

using System;
using System.Management;
public class RemoteConnect 
{
    public static void Main() 
    {
        EnumerationOptions opt = new EnumerationOptions(
            null, System.TimeSpan.MaxValue,
            1, true, true, false, 
            true, false, false, true);

        ManagementClass c = new ManagementClass("CIM_Service");
        foreach (ManagementObject o in c.GetInstances(opt))
            Console.WriteLine(o["Name"]);
    }
}

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

EnumerationOptions-Klasse
EnumerationOptions-Member
System.Management-Namespace