WqlEventQuery 建構函式

定義

命名空間:: System.Management

組件:: System.Management.dll

套件:: System.Management v11.0.0-rc.1.26425.128

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

名稱	Description
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

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

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

public:
 WqlEventQuery();

public WqlEventQuery();

Public Sub New ()

備註

.NET Framework 安全性

完全信任當下的來電者。此成員無法被部分受信任的程式碼使用。欲了解更多資訊，請參閱「部分受信任程式碼的函式庫使用」。

適用於

WqlEventQuery(String)

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: 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

字串代表整個事件查詢或查詢事件類別名稱。物件會嘗試解析該字串作為有效的事件查詢。若未成功，解析器會假設該參數代表事件類別名稱。

範例

以下範例透過指定查詢初始化 a WqlEventQuery ，接著透過指定事件初始化 a 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

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: 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

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: 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 必須輪詢條件的情況。此間隔是必須送達事件通知前最多可過的時間。

範例

以下範例透過指定事件及時間範圍值來初始化 a 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

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: 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

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: 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

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: 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

來源:: ManagementQuery.cs

來源:: ManagementQuery.cs

來源:: 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

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 安全性

完全信任當下的來電者。此成員無法被部分受信任的程式碼使用。欲了解更多資訊，請參閱「部分受信任程式碼的函式庫使用」。

適用於

意見反應

此頁面對您有幫助嗎？