EventQuery Klasse

Definition

Namespace:

System.Management

Assembly:

System.Management.dll

Paket:

System.Management v11.0.0-preview.4.26230.115

Quelle:

ManagementQuery.cs

Stellt eine WMI-Ereignisabfrage dar.

public ref class EventQuery : System::Management::ManagementQuery

public class EventQuery : System.Management.ManagementQuery

type EventQuery = class
    inherit ManagementQuery

Public Class EventQuery
Inherits ManagementQuery

Vererbung

Object

ManagementQuery

EventQuery

Abgeleitet

System.Management.WqlEventQuery

Beispiele

Das folgende Beispiel zeigt, wie der Client eine Benachrichtigung empfängt, wenn eine Instanz von Win32_Process erstellt wird, da die Ereignisklasse __InstanceCreationEvent ist. Weitere Informationen finden Sie in der Dokumentation Windows Management Instrumentation. Der Client empfängt Ereignisse synchron, indem die WaitForNextEvent Methode aufgerufen wird. Dieses Beispiel kann getestet werden, indem ein Prozess gestartet wird, z. B. Editor, während der Beispielcode ausgeführt wird.

using System;
using System.Management;

// This example shows synchronous consumption of events.
// The client is blocked while waiting for events.

public class EventWatcherPolling
{
    public static int Main(string[] args)
    {
        // Create event query to be notified within 1 second of
        // a change in a service
        EventQuery query = new EventQuery();
        query.QueryString = "SELECT * FROM" +
            " __InstanceCreationEvent WITHIN 1 " +
            "WHERE TargetInstance isa \"Win32_Process\"";

        // Initialize an event watcher and subscribe to events
        // that match this query
        ManagementEventWatcher watcher =
            new ManagementEventWatcher(query);
        // times out watcher.WaitForNextEvent in 5 seconds
        watcher.Options.Timeout = new TimeSpan(0,0,5);

        // Block until the next event occurs
        // Note: this can be done in a loop if waiting for
        //        more than one occurrence
        Console.WriteLine(
            "Open an application (notepad.exe) to trigger an event.");
        ManagementBaseObject e = watcher.WaitForNextEvent();

        //Display information from the event
        Console.WriteLine(
            "Process {0} has been created, path is: {1}",
            ((ManagementBaseObject)e
            ["TargetInstance"])["Name"],
            ((ManagementBaseObject)e
            ["TargetInstance"])["ExecutablePath"]);

        //Cancel the subscription
        watcher.Stop();
        return 0;
    }
}

Imports System.Management

' This example shows synchronous consumption of events. 
' The client is blocked while waiting for events. 

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

        ' Create event query to be notified within 1 second of 
        ' a change in a service
        Dim query As New EventQuery
        query.QueryString = "SELECT * FROM" & _
            " __InstanceCreationEvent WITHIN 1 " & _
            "WHERE TargetInstance isa ""Win32_Process"""

        ' Initialize an event watcher and subscribe to events 
        ' that match this query
        Dim watcher As New ManagementEventWatcher(query)
        ' times watcher.WaitForNextEvent in 5 seconds
        watcher.Options.Timeout = New TimeSpan(0, 0, 50)

        ' Block until the next event occurs 
        ' Note: this can be done in a loop
        ' if waiting for more than one occurrence
        Console.WriteLine( _
          "Open an application (notepad.exe) to trigger an event.")
        Dim e As ManagementBaseObject = _
            watcher.WaitForNextEvent()

        'Display information from the event
        Console.WriteLine( _
            "Process {0} has created, path is: {1}", _
            CType(e("TargetInstance"), _
                ManagementBaseObject)("Name"), _
            CType(e("TargetInstance"), _
                ManagementBaseObject)("ExecutablePath"))

        'Cancel the subscription
        watcher.Stop()
        Return 0

    End Function 'Main
End Class

Konstruktoren

Name	Beschreibung
EventQuery()	Initialisiert eine neue Instanz der EventQuery-Klasse. Dies ist der parameterlose Konstruktor.
EventQuery(String, String)	Initialisiert eine neue Instanz der EventQuery Klasse für die angegebene Sprache und Abfrage.
EventQuery(String)	Initialisiert eine neue Instanz der EventQuery Klasse für die angegebene Abfrage.

Eigenschaften

Name	Beschreibung
QueryLanguage	Ruft die abfragesprache ab, die in der Abfragezeichenfolge verwendet wird, oder legt sie fest, die das Format der Abfragezeichenfolge definiert. (Geerbt von ManagementQuery)
QueryString	Ruft die Abfrage im Textformat ab oder legt sie fest. (Geerbt von ManagementQuery)

Methoden

Name	Beschreibung
Clone()	Gibt eine Kopie des Objekts zurück.
ParseQuery(String)	Analysiert die Abfragezeichenfolge und legt die Eigenschaftswerte entsprechend fest. Wenn die Abfrage gültig ist, werden die Klassennameneigenschaft und die Bedingungseigenschaft der Abfrage analysiert. (Geerbt von ManagementQuery)