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()

Source:

ManagementQuery.cs

初始化 WqlEventQuery 类的新实例。 这是无参数构造函数。

public:
 WqlEventQuery();

public WqlEventQuery ();

Public Sub New ()

注解

.NET Framework 安全性

对直接调用方的完全信任。 此成员不能由部分信任的代码使用。 有关详细信息，请参阅 使用部分受信任的代码中的库。

WqlEventQuery(String)

Source:

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)

Source:

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)

Source:

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)

Source:

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)

Source:

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[])

Source:

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)

Source:

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

对直接调用方的完全信任。 此成员不能由部分信任的代码使用。 有关详细信息，请参阅 使用部分受信任的代码中的库。