WqlEventQuery 建構函式

定義

命名空間:

System.Management

組件:

System.Management.dll

套件:

System.Management v8.0.0

初始化 WqlEventQuery 類別的新執行個體。

多載

WqlEventQuery()	初始化 WqlEventQuery 類別的新執行個體。 這是無參數建構函式。
WqlEventQuery(String)	根據指定的查詢字串或事件類別名稱，初始化 WqlEventQuery 類別的新執行個體。
WqlEventQuery(String, String)	使用指定條件，為指定事件類別名稱初始化 WqlEventQuery 類別的新執行個體。
WqlEventQuery(String, TimeSpan)	使用指定延遲時間，為指定事件類別初始化 WqlEventQuery 類別的新執行個體。
WqlEventQuery(String, String, TimeSpan)	使用指定的事件類別名稱、條件和群組間隔，初始化 WqlEventQuery 類別的新執行個體。
WqlEventQuery(String, TimeSpan, String)	使用指定的事件類別名稱、輪詢間隔和條件，初始化 WqlEventQuery 類別的新執行個體。
WqlEventQuery(String, String, TimeSpan, String[])	使用指定的事件類別名稱、條件、群組間隔和群組屬性，初始化 WqlEventQuery 類別的新執行個體。
WqlEventQuery(String, TimeSpan, String, TimeSpan, String[], String)	使用指定的事件類別名稱、條件、群組間隔、群組屬性和指定的事件數目，初始化 WqlEventQuery 類別的新執行個體。

WqlEventQuery()

來源:

ManagementQuery.cs

初始化 WqlEventQuery 類別的新執行個體。 這是無參數建構函式。

public:
 WqlEventQuery();

public WqlEventQuery ();

Public Sub New ()

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。

WqlEventQuery(String)

來源:

ManagementQuery.cs

根據指定的查詢字串或事件類別名稱，初始化 WqlEventQuery 類別的新執行個體。

public:
 WqlEventQuery(System::String ^ queryOrEventClassName);

public WqlEventQuery (string queryOrEventClassName);

new System.Management.WqlEventQuery : string -> System.Management.WqlEventQuery

Public Sub New (queryOrEventClassName As String)

參數

queryOrEventClassName

String

表示整個事件查詢或所要查詢事件類別名稱的字串。 物件會嘗試將字串剖析為有效的事件查詢。 如果不成功，則剖析器會假設參數表示事件類別名稱。

範例

下列範例會 WqlEventQuery 藉由指定查詢來初始化 ， WqlEventQuery 然後藉由指定 事件來初始化 。

using System;
using System.Management;

public class EventSample
{
    public static void Main(string[] args)
    {
        // Full query string specified to the constructor
        WqlEventQuery q =
            new WqlEventQuery("SELECT * FROM Win32_ComputerShutdownEvent");

        // Only relevant event class name specified to the constructor
        // Results in the same query as above.
        WqlEventQuery query =
            new WqlEventQuery("Win32_ComputerShutdownEvent ");

        Console.WriteLine(query.QueryString);
        return;
    }
}

Imports System.Management


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

        '' Full query string specified to the constructor
        Dim q As New WqlEventQuery( _
            "SELECT * FROM Win32_ComputerShutdownEvent ")

        ' Only relevant event class name specified to the constructor
        ' Results in the same query as above   
        Dim query As New WqlEventQuery("Win32_ComputerShutdownEvent ")

        MessageBox.Show(query.QueryString)

    End Function 'Main
End Class

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。

WqlEventQuery(String, String)

來源:

ManagementQuery.cs

使用指定條件，為指定事件類別名稱初始化 WqlEventQuery 類別的新執行個體。

public:
 WqlEventQuery(System::String ^ eventClassName, System::String ^ condition);

public WqlEventQuery (string eventClassName, string condition);

new System.Management.WqlEventQuery : string * string -> System.Management.WqlEventQuery

Public Sub New (eventClassName As String, condition As String)

參數

eventClassName

String

要查詢的事件類別名稱。

condition

String

要套用至指定類別的事件的條件。

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。

WqlEventQuery(String, TimeSpan)

來源:

ManagementQuery.cs

使用指定延遲時間，為指定事件類別初始化 WqlEventQuery 類別的新執行個體。

public:
 WqlEventQuery(System::String ^ eventClassName, TimeSpan withinInterval);

public WqlEventQuery (string eventClassName, TimeSpan withinInterval);

new System.Management.WqlEventQuery : string * TimeSpan -> System.Management.WqlEventQuery

Public Sub New (eventClassName As String, withinInterval As TimeSpan)

參數

eventClassName

String

要查詢的事件類別名稱。

withinInterval

TimeSpan

TimeSpan 值，指定接收這個事件時可以接受的延遲時間。 這個值用於所要求的查詢沒有明確的事件提供者的狀況中，並且 WMI 必須輪詢條件。 這個間隔是事件告知必須傳遞之前所能夠等待的最長時間。

範例

下列範例會 WqlEventQuery 藉由指定事件和時間範圍值，指定接收此事件的延遲，以初始化 。

using System;
using System.Management;

public class EventSample
{
    public static void Main(string[] args)
    {
        // Requests all instance creation events,
        // with a specified latency of
        // 10 seconds. The query created
        // is "SELECT * FROM __InstanceCreationEvent WITHIN 10"
        WqlEventQuery q = new WqlEventQuery("__InstanceCreationEvent",
            new TimeSpan(0,0,10));

        Console.WriteLine(q.QueryString);
        return;
    }
}

Imports System.Management


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

        ' Requests all instance creation events,
        ' with a specified latency of
        ' 10 seconds. The query created
        ' is "SELECT * FROM __InstanceCreationEvent WITHIN 10"
        Dim t As New TimeSpan(0, 0, 10)
        Dim q As New WqlEventQuery("__InstanceCreationEvent", t)

        MessageBox.Show(q.QueryString)

    End Function 'Main
End Class

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。

WqlEventQuery(String, String, TimeSpan)

來源:

ManagementQuery.cs

使用指定的事件類別名稱、條件和群組間隔，初始化 WqlEventQuery 類別的新執行個體。

public:
 WqlEventQuery(System::String ^ eventClassName, System::String ^ condition, TimeSpan groupWithinInterval);

public WqlEventQuery (string eventClassName, string condition, TimeSpan groupWithinInterval);

new System.Management.WqlEventQuery : string * string * TimeSpan -> System.Management.WqlEventQuery

Public Sub New (eventClassName As String, condition As String, groupWithinInterval As TimeSpan)

參數

eventClassName

String

要查詢的事件類別名稱。

condition

String

要套用至指定類別的事件的條件。

groupWithinInterval

TimeSpan

WMI 傳送一個 aggregate event的指定間隔，而不是許多事件。

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。

WqlEventQuery(String, TimeSpan, String)

來源:

ManagementQuery.cs

使用指定的事件類別名稱、輪詢間隔和條件，初始化 WqlEventQuery 類別的新執行個體。

public:
 WqlEventQuery(System::String ^ eventClassName, TimeSpan withinInterval, System::String ^ condition);

public WqlEventQuery (string eventClassName, TimeSpan withinInterval, string condition);

new System.Management.WqlEventQuery : string * TimeSpan * string -> System.Management.WqlEventQuery

Public Sub New (eventClassName As String, withinInterval As TimeSpan, condition As String)

參數

eventClassName

String

要查詢的事件類別名稱。

withinInterval

TimeSpan

TimeSpan 值，指定接收這個事件時可以接受的延遲時間。 這個值用於所要求的查詢沒有明確的事件提供者的狀況中，並且 WMI 必須輪詢條件。 這個間隔是事件告知必須傳遞之前所能夠等待的最長時間。

condition

String

要套用至指定類別的事件的條件。

範例

下列範例會建立事件查詢：「SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA Win32_Service」，它會傳送建立 Win32_Service 實例的通知，並具有 10 秒輪詢間隔。

using System;
using System.Management;

public class EventSample
{
    public static void Main(string[] args)
    {
        // Requests notification of the creation
        // of Win32_Service instances with
        // a 10 second allowed latency.
        WqlEventQuery q = new WqlEventQuery("__InstanceCreationEvent",
            new TimeSpan(0,0,10),
            "TargetInstance isa 'Win32_Service'");

        Console.WriteLine(q.QueryString);
        return;
    }
}

Imports System.Management


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

        ' Requests notification of the creation
        ' of Win32_Service instances with a 10 second
        ' allowed latency.
        Dim t As New TimeSpan(0, 0, 10)
        Dim q As New WqlEventQuery("__InstanceCreationEvent", _
            t, "TargetInstance isa ""Win32_Service""")

        MessageBox.Show(q.QueryString)

    End Function 'Main
End Class

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。

WqlEventQuery(String, String, TimeSpan, String[])

來源:

ManagementQuery.cs

使用指定的事件類別名稱、條件、群組間隔和群組屬性，初始化 WqlEventQuery 類別的新執行個體。

public:
 WqlEventQuery(System::String ^ eventClassName, System::String ^ condition, TimeSpan groupWithinInterval, cli::array <System::String ^> ^ groupByPropertyList);

public WqlEventQuery (string eventClassName, string condition, TimeSpan groupWithinInterval, string[] groupByPropertyList);

new System.Management.WqlEventQuery : string * string * TimeSpan * string[] -> System.Management.WqlEventQuery

Public Sub New (eventClassName As String, condition As String, groupWithinInterval As TimeSpan, groupByPropertyList As String())

參數

eventClassName

String

要查詢的事件類別名稱。

condition

String

要套用至指定類別的事件的條件。

groupWithinInterval

TimeSpan

WMI 傳送一個 aggregate event的指定間隔，而不是許多事件。

groupByPropertyList

String[]

事件類別中的屬性，事件應該根據這個屬性劃分群組。

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。

WqlEventQuery(String, TimeSpan, String, TimeSpan, String[], String)

來源:

ManagementQuery.cs

使用指定的事件類別名稱、條件、群組間隔、群組屬性和指定的事件數目，初始化 WqlEventQuery 類別的新執行個體。

public:
 WqlEventQuery(System::String ^ eventClassName, TimeSpan withinInterval, System::String ^ condition, TimeSpan groupWithinInterval, cli::array <System::String ^> ^ groupByPropertyList, System::String ^ havingCondition);

public WqlEventQuery (string eventClassName, TimeSpan withinInterval, string condition, TimeSpan groupWithinInterval, string[] groupByPropertyList, string havingCondition);

new System.Management.WqlEventQuery : string * TimeSpan * string * TimeSpan * string[] * string -> System.Management.WqlEventQuery

Public Sub New (eventClassName As String, withinInterval As TimeSpan, condition As String, groupWithinInterval As TimeSpan, groupByPropertyList As String(), havingCondition As String)

參數

eventClassName

String

要在其上查詢的事件類別名稱。

withinInterval

TimeSpan

TimeSpan 值，指定接收這個事件時可以接受的延遲時間。 這個值用於所要求的查詢沒有明確的事件提供者的狀況中，並且 WMI 必須輪詢條件。 這個間隔是事件告知必須傳遞之前所能夠等待的最長時間。

condition

String

要套用至指定類別的事件的條件。

groupWithinInterval

TimeSpan

WMI 傳送一個 aggregate event的指定間隔，而不是許多事件。

groupByPropertyList

String[]

事件類別中的屬性，事件應該根據這個屬性劃分群組。

havingCondition

String

要套用至事件數目的條件。

範例

下列範例會建立事件查詢：「SELECT * FROM __InstanceCreationEvent WHERE TargetInstance ISA Win32_NTLogEvent GROUP WITHIN 600 BY TargetInstance.SourceName HAVING NumberOfEvents > 15」，只有在從相同來源收到的 Win32_NTLogEvent 事件數目超過 15 時，才會傳遞匯總事件。

using System;
using System.Management;

public class EventSample
{
    public static void Main(string[] args)
    {
        // Requests sending aggregated events
        // if the number of events exceeds 15.
        String[] props = {"TargetInstance.SourceName"};
        WqlEventQuery q =
            new WqlEventQuery(
            "__InstanceCreationEvent",
            System.TimeSpan.MaxValue,
            "TargetInstance isa 'Win32_NTLogEvent'",
            new TimeSpan(0,10,0),
            props,
            "NumberOfEvents >15");

        Console.WriteLine(q.QueryString);
        return;
    }
}

Imports System.Management


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

        ' Requests sending aggregated events
        ' if the number of events exceeds 15.
        Dim props() As String = {"TargetInstance.SourceName"}
        Dim t As New TimeSpan(0, 10, 0)
        Dim q As New WqlEventQuery("__InstanceCreationEvent", _
            System.TimeSpan.MaxValue, _
            "TargetInstance isa ""Win32_NTLogEvent""", _
            t, _
            props, _
            "NumberOfEvents >15")

        MessageBox.Show(q.QueryString)

    End Function 'Main
End Class

備註

.NET Framework 安全性

完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊，請參閱 使用部分信任程式代碼的連結庫。