EventQuery 類別

定義

命名空間:

System.Management

組件:

System.Management.dll

表示 WMI「事件查詢」。

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

public class EventQuery : System.Management.ManagementQuery

type EventQuery = class
    inherit ManagementQuery

Public Class EventQuery
Inherits ManagementQuery

繼承

Object

ManagementQuery

EventQuery

衍生

System.Management.WqlEventQuery

範例

下列範例顯示當建立 Win32_Process 實例時，用戶端如何接收通知，因為事件類別 __InstanceCreationEvent。 如需詳細資訊，請參閱Windows Management Instrumentation檔。 用戶端呼叫 WaitForNextEvent 方法，就可以同步接收事件。 在範例程式碼執行時，可以透過啟動處理序 (例如，[記事本]) 來測試這個範例。

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

建構函式

EventQuery()	初始化 EventQuery 類別的新執行個體。 這是無參數建構函式。
EventQuery(String)	為指定的查詢初始化 EventQuery 類別的新執行個體。
EventQuery(String, String)	為指定的語言和查詢初始化 EventQuery 類別的新執行個體。

屬性

QueryLanguage	取得或設定使用於查詢字串中的查詢語言，定義查詢字串的格式。 (繼承來源 ManagementQuery)
QueryString	取得或設定文字格式的查詢。 (繼承來源 ManagementQuery)

方法

Clone()	傳回物件的複本。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ParseQuery(String)	剖析查詢字串，並相應的設定屬性值。 如果查詢有效，便會剖析查詢的類別名稱屬性及 Condition 屬性。 (繼承來源 ManagementQuery)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)