Freigeben über


EnumerationOptions Klasse

Definition

Stellt eine Basisklasse für Objekte mit Optionen für Abfragen und Enumerationen bereit.

public ref class EnumerationOptions : System::Management::ManagementOptions
public class EnumerationOptions : System.Management.ManagementOptions
type EnumerationOptions = class
    inherit ManagementOptions
Public Class EnumerationOptions
Inherits ManagementOptions
Vererbung
EnumerationOptions

Beispiele

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

using System;
using System.Management;
public class RemoteConnect
{
    public static void Main()
    {
        EnumerationOptions opt = new EnumerationOptions();
        // Will enumerate instances of the given class
        // and any subclasses.
        opt.EnumerateDeep = true;
        ManagementClass c = new ManagementClass("CIM_Service");
        foreach (ManagementObject o in c.GetInstances(opt))
            Console.WriteLine(o["Name"]);
    }
}
Imports System.Management
Public Class RemoteConnect

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

        Dim opt As New EnumerationOptions
        ' Will enumerate instances of the given class
        ' and any subclasses.
        opt.EnumerateDeep = 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

Konstruktoren

EnumerationOptions()

Initialisiert eine neue Instanz der EnumerationOptions-Klasse mit Standardwerten. (Eine Definition der jeweiligen Standardwerte finden Sie unter den Beschreibungen der einzelnen Eigenschaften.) Dies ist der parameterlose Konstruktor.

EnumerationOptions(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.

Eigenschaften

BlockSize

Ruft die Blockgröße für Blockoperationen ab oder legt diese fest. Bei der Enumeration einer Auflistung gibt WMI Ergebnisse in Gruppen der angegebenen Größe zurück.

Context

Ruft ein WMI-Kontextobjekt ab oder legt dieses fest. Dies ist eine Liste von Name-Wert-Paaren, die zur Übergabe an einen WMI-Anbieter bestimmt ist, der Kontextinformationen für benutzerdefinierte Operationen unterstützt.

(Geerbt von ManagementOptions)
DirectRead

Ruft einen Wert ab, der anzeigt, ob Direktzugriff auf den WMI-Anbieter für die angegebene Klasse angefordert wird, oder legt diesen fest, ohne dessen übergeordnete Klasse oder abgeleitete Klassen in Betracht zu ziehen.

EnsureLocatable

Ruft einen Wert ab, der angibt, ob die zurückgegebenen Objekte gebietsschemabezogene Informationen enthalten sollen, oder legt diesen fest. Dies gewährleistet, dass Systemeigenschaften wie __PATH, __RELPATH, Und __SERVER ungleich NULL sind. Dieses Flag kann nur in Abfragen verwendet werden und wird in Enumerationen ignoriert.

EnumerateDeep

Ruft einen Wert ab, der angibt, ob für alle Klassen, die von der angegebenen übergeordneten Klasse abgeleitet sind, rekursive Enumeration angefordert wird, oder legt diesen fest. Wenn false, werden nur direkt abgeleitete Klassenmember zurückgegeben.

PrototypeOnly

Ruft einen Wert ab, der angibt, ob die Abfrage anstelle der eigentlichen Ergebnisse einen Prototyp des Resultsets zurückgeben soll, oder legt diesen fest. Dieses Flag wird für das Erstellen von Prototypen verwendet.

ReturnImmediately

Ruft einen Wert ab, der angibt, ob die aufgerufene Operation synchron oder halbsynchron durchgeführt werden soll. Wenn diese Eigenschaft auf true festgelegt ist, wird die Enumeration aufgerufen, und der Aufruf wird unmittelbar zurückgegeben. Das eigentliche Abrufen der Ergebnisse findet beim Durchlaufen der resultierenden Auflistung statt.

Rewindable

Ruft einen Wert ab, der angibt, ob die Auflistung als rücklauffähig angesehen wird, oder legt diesen fest. true gibt an, dass die Objekte in der Auflistung für weitere Enumerationen verfügbar bleiben. false gibt an, dass nur eine einmalige Enumeration der Auflistung möglich ist.

Timeout

Ruft das für die Operation geltende Timeout ab oder legt dieses fest. Beachten Sie Folgendes: Dieses Timeout gilt bei Operationen, die Auflistungen zurückgeben, für die Enumeration der resultierenden Auflistung, aber nicht für die eigentliche Operation (die ReturnImmediately-Eigenschaft wird für die eigentliche Operation verwendet). Mit dieser Eigenschaft wird angegeben, dass die Operation halbsynchron durchzuführen ist.

(Geerbt von ManagementOptions)
UseAmendedQualifiers

Ruft einen Wert ab, der angibt, ob die von der WMI zurückgegebenen Objekte geänderte Informationen enthalten. Normalerweise handelt es sich bei ergänzenden Informationen um lokalisierbare Informationen, die an das WMI-Objekt angefügt sind, z. B. um Objekt- und Eigenschaftsbeschreibungen.

Methoden

Clone()

Gibt eine Kopie des Objekts zurück.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für: