WqlEventQuery Konstruktoren

Definition

Namespace:

System.Management

Assembly:

System.Management.dll

Paket:

System.Management v8.0.0

Initialisiert eine neue Instanz der WqlEventQuery-Klasse.

Überlädt

WqlEventQuery()	Initialisiert eine neue Instanz der WqlEventQuery-Klasse. Dies ist der parameterlose Konstruktor.
WqlEventQuery(String)	Initialisiert eine neue Instanz der WqlEventQuery-Klasse, die auf der angegebenen Abfragezeichenfolge bzw. dem angegebenen Ereignisklassennamen beruht.
WqlEventQuery(String, String)	Initialisiert eine neue Instanz der WqlEventQuery-Klasse für den angegebenen Ereignisklassennamen mit der angegebenen Bedingung.
WqlEventQuery(String, TimeSpan)	Initialisiert eine neue Instanz der WqlEventQuery-Klasse für die angegebene Ereignisklasse mit der angegebenen Wartezeit.
WqlEventQuery(String, String, TimeSpan)	Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, der Bedingung und dem Gruppierungsintervall.
WqlEventQuery(String, TimeSpan, String)	Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, dem angegebenen Abrufintervall und der angegebenen Bedingung.
WqlEventQuery(String, String, TimeSpan, String[])	Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, der angegebenen Bedingung, dem angegebenen Gruppierungsintervall und den angegebenen Gruppierungseigenschaften.
WqlEventQuery(String, TimeSpan, String, TimeSpan, String[], String)	Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, der angegebenen Bedingung, dem angegebenen Gruppierungsintervall, den angegebenen Gruppierungseigenschaften und der angegebenen Anzahl von Ereignissen.

WqlEventQuery()

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse. Dies ist der parameterlose Konstruktor.

public:
 WqlEventQuery();

public WqlEventQuery ();

Public Sub New ()

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

WqlEventQuery(String)

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse, die auf der angegebenen Abfragezeichenfolge bzw. dem angegebenen Ereignisklassennamen beruht.

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

public WqlEventQuery (string queryOrEventClassName);

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

Public Sub New (queryOrEventClassName As String)

Parameter

queryOrEventClassName

String

Die Zeichenfolge, die entweder die vollständige Ereignisabfrage oder den Namen der abzufragenden Ereignisklasse darstellt. Das Objekt versucht, die Zeichenfolge als gültige Ereignisabfrage zu analysieren. Wenn dies nicht möglich ist, geht der Parser davon aus, dass der Parameter einen Ereignisklassennamen darstellt.

Beispiele

Im folgenden Beispiel wird eine initialisiert, WqlEventQuery indem eine Abfrage angegeben wird, und dann wird eine WqlEventQuery initialisiert, indem ein -Ereignis angegeben wird.

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

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

WqlEventQuery(String, String)

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse für den angegebenen Ereignisklassennamen mit der angegebenen Bedingung.

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)

Parameter

eventClassName

String

Der Name der abzufragenden Ereignisklasse.

condition

String

Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

WqlEventQuery(String, TimeSpan)

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse für die angegebene Ereignisklasse mit der angegebenen Wartezeit.

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)

Parameter

eventClassName

String

Der Name der abzufragenden Ereignisklasse.

withinInterval

TimeSpan

Ein TimeSpan-Wert, der die für das Empfangen dieses Ereignisses zulässige Wartezeit angibt. Dieser Wert wird verwendet, wenn für die angeforderte Abfrage kein expliziter Ereignisanbieter vorhanden ist und WMI die Bedingung abrufen muss. Das Intervall ist der höchstzulässige Zeitraum, der vor dem Übermitteln einer Ereignisbenachrichtigung verstreichen darf.

Beispiele

Im folgenden Beispiel wird eine WqlEventQuery initialisiert, indem ein Ereignis und ein Zeitbereichswert angegeben werden, der die für den Empfang dieses Ereignisses zulässige Latenz angibt.

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

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

WqlEventQuery(String, String, TimeSpan)

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, der Bedingung und dem Gruppierungsintervall.

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)

Parameter

eventClassName

String

Der Name der abzufragenden Ereignisklasse.

condition

String

Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.

groupWithinInterval

TimeSpan

Das angegebene Intervall, in dem WMI anstelle vieler Ereignisse ein aggregate event-Ereignis sendet.

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

WqlEventQuery(String, TimeSpan, String)

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, dem angegebenen Abrufintervall und der angegebenen Bedingung.

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)

Parameter

eventClassName

String

Der Name der abzufragenden Ereignisklasse.

withinInterval

TimeSpan

Ein TimeSpan-Wert, der die für das Empfangen dieses Ereignisses zulässige Wartezeit angibt. Dieser Wert wird verwendet, wenn für die angeforderte Abfrage kein expliziter Ereignisanbieter vorhanden ist und WMI die Bedingung abrufen muss. Das Intervall ist der höchstzulässige Zeitraum, der vor dem Übermitteln einer Ereignisbenachrichtigung verstreichen darf.

condition

String

Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.

Beispiele

Im folgenden Beispiel wird die Ereignisabfrage "SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA Win32_Service " erstellt, die eine Benachrichtigung über die Erstellung von Win32_Service-Instanzen mit einem Abrufintervall von 10 Sekunden sendet.

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

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

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

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, der angegebenen Bedingung, dem angegebenen Gruppierungsintervall und den angegebenen Gruppierungseigenschaften.

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

Parameter

eventClassName

String

Der Name der abzufragenden Ereignisklasse.

condition

String

Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.

groupWithinInterval

TimeSpan

Das angegebene Intervall, in dem WMI anstelle vieler Ereignisse ein aggregate event-Ereignis sendet.

groupByPropertyList

String[]

Die Eigenschaften in der Ereignisklasse, nach denen die Ereignisse gruppiert werden sollen.

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

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

Quelle:

ManagementQuery.cs

Initialisiert eine neue Instanz der WqlEventQuery-Klasse mit dem angegebenen Ereignisklassennamen, der angegebenen Bedingung, dem angegebenen Gruppierungsintervall, den angegebenen Gruppierungseigenschaften und der angegebenen Anzahl von Ereignissen.

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)

Parameter

eventClassName

String

Der Name der Ereignisklasse, für die die Abfrage ausgeführt werden soll.

withinInterval

TimeSpan

Ein TimeSpan-Wert, der die für das Empfangen dieses Ereignisses zulässige Wartezeit angibt. Dieser Wert wird verwendet, wenn für die angeforderte Abfrage kein expliziter Ereignisanbieter vorhanden ist und WMI die Bedingung abrufen muss. Das Intervall ist der höchstzulässige Zeitraum, der vor dem Übermitteln einer Ereignisbenachrichtigung verstreichen darf.

condition

String

Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.

groupWithinInterval

TimeSpan

Das angegebene Intervall, in dem WMI anstelle vieler Ereignisse ein aggregate event-Ereignis sendet.

groupByPropertyList

String[]

Die Eigenschaften in der Ereignisklasse, nach denen die Ereignisse gruppiert werden sollen.

havingCondition

String

Die Bedingung, die auf die Anzahl von Ereignissen angewendet werden soll.

Beispiele

Im folgenden Beispiel wird die Ereignisabfrage "SELECT * FROM __InstanceCreationEvent WHERE TargetInstance ISA Win32_NTLogEvent GROUP WITHIN 600 BY TargetInstance.SourceName HAVING NumberOfEvents > 15" erstellt, die nur aggregierte Ereignisse liefert, wenn die Anzahl der von derselben Quelle empfangenen Win32_NTLogEvent Ereignisse 15 überschreitet.

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

Hinweise

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.