WqlEventQuery Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der WqlEventQuery-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| WqlEventQuery() |
Initialisiert eine neue Instanz der WqlEventQuery-Klasse. Dies ist der parameterlose Konstruktor. |
| WqlEventQuery(String) |
Initialisiert eine neue Instanz der WqlEventQuery Klasse basierend auf dem angegebenen Abfragezeichenfolgen- oder Ereignisklassennamen. |
| 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 Latenzzeit. |
| 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, Abrufintervall und Bedingung. |
| WqlEventQuery(String, String, TimeSpan, String[]) |
Initialisiert eine neue Instanz der WqlEventQuery Klasse mit dem angegebenen Ereignisklassennamen, der Bedingung, dem Gruppierungsintervall und der Gruppierungseigenschaften. |
| WqlEventQuery(String, TimeSpan, String, TimeSpan, String[], String) |
Initialisiert eine neue Instanz der WqlEventQuery Klasse mit dem angegebenen Ereignisklassennamen, der Bedingung, dem Gruppierungsintervall, der Gruppierungseigenschaften und der angegebenen Anzahl von Ereignissen. |
WqlEventQuery()
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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ürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
WqlEventQuery(String)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
Initialisiert eine neue Instanz der WqlEventQuery Klasse basierend auf dem angegebenen Abfragezeichenfolgen- oder Ereignisklassennamen.
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 gesamte Ereignisabfrage oder den Namen der zu abfragenden Ereignisklasse darstellt. Das Objekt versucht, die Zeichenfolge als gültige Ereignisabfrage zu analysieren. Wenn dies nicht erfolgreich ist, geht der Parser davon aus, dass der Parameter einen Ereignisklassennamen darstellt.
Beispiele
Im folgenden Beispiel wird eine WqlEventQuery durch Angabe einer Abfrage initialisiert und anschließend durch WqlEventQuery Angeben eines Ereignisses initialisiert.
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ürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
WqlEventQuery(String, String)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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 zu abfragenden Ereignisklasse.
- condition
- String
Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.
Hinweise
.NET Framework-Sicherheit
Volle Vertrauenswürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
WqlEventQuery(String, TimeSpan)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
Initialisiert eine neue Instanz der WqlEventQuery Klasse für die angegebene Ereignisklasse mit der angegebenen Latenzzeit.
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 zu abfragenden Ereignisklasse.
- withinInterval
- TimeSpan
Ein TimeSpan Wert, der die für den Empfang dieses Ereignisses akzeptable Latenz angibt. Dieser Wert wird in Fällen verwendet, in denen es keinen expliziten Ereignisanbieter für die angeforderte Abfrage gibt, und WMI ist erforderlich, um die Bedingung abzufragen. Dieses Intervall ist die maximale Zeitspanne, die vor der Benachrichtigung eines Ereignisses übergeben werden kann.
Beispiele
Im folgenden Beispiel wird ein WqlEventQuery Ereignis initialisiert, indem ein Ereignis und ein Zeitspannwert angegeben wird, der die für den Empfang dieses Ereignisses akzeptable 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ürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
WqlEventQuery(String, String, TimeSpan)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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 zu abfragenden 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 eins aggregate eventsendet.
Hinweise
.NET Framework-Sicherheit
Volle Vertrauenswürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
WqlEventQuery(String, TimeSpan, String)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
Initialisiert eine neue Instanz der WqlEventQuery Klasse mit dem angegebenen Ereignisklassennamen, Abrufintervall und 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 zu abfragenden Ereignisklasse.
- withinInterval
- TimeSpan
Ein TimeSpan Wert, der die für den Empfang dieses Ereignisses akzeptable Latenz angibt. Dieser Wert wird in Fällen verwendet, in denen keine explizite Ereignisanbieter für die angeforderte Abfrage vorhanden ist und WMI zum Abrufen der Bedingung erforderlich ist. Dieses Intervall ist die maximale Zeitspanne, die vor der Benachrichtigung eines Ereignisses übergeben werden kann.
- condition
- String
Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.
Beispiele
Im folgenden Beispiel wird die Ereignisabfrage erstellt: "SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA Win32_Service ", die Benachrichtigung über die Erstellung von Win32_Service Instanzen mit einem Abfrageintervall 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ürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
WqlEventQuery(String, String, TimeSpan, String[])
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
Initialisiert eine neue Instanz der WqlEventQuery Klasse mit dem angegebenen Ereignisklassennamen, der Bedingung, dem Gruppierungsintervall und der 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 zu abfragenden 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 eins aggregate eventsendet.
- groupByPropertyList
- String[]
Die Eigenschaften in der Ereignisklasse, nach der die Ereignisse gruppiert werden sollen.
Hinweise
.NET Framework-Sicherheit
Volle Vertrauenswürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
WqlEventQuery(String, TimeSpan, String, TimeSpan, String[], String)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
Initialisiert eine neue Instanz der WqlEventQuery Klasse mit dem angegebenen Ereignisklassennamen, der Bedingung, dem Gruppierungsintervall, der 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 abgefragt werden soll.
- withinInterval
- TimeSpan
Ein TimeSpan Wert, der die für den Empfang dieses Ereignisses akzeptable Latenz angibt. Dieser Wert wird in Fällen verwendet, in denen es keinen expliziten Ereignisanbieter für die angeforderte Abfrage gibt, und WMI ist erforderlich, um die Bedingung abzufragen. Dieses Intervall ist die maximale Zeitspanne, die vor der Benachrichtigung eines Ereignisses übergeben werden kann.
- condition
- String
Die Bedingung, die auf Ereignisse der angegebenen Klasse angewendet werden soll.
- groupWithinInterval
- TimeSpan
Das angegebene Intervall, in dem WMI anstelle vieler Ereignisse eins aggregate eventsendet.
- groupByPropertyList
- String[]
Die Eigenschaften in der Ereignisklasse, nach der die Ereignisse gruppiert werden sollen.
- havingCondition
- String
Die Bedingung, die auf die Anzahl der Ereignisse angewendet werden soll.
Beispiele
Im folgenden Beispiel wird die Ereignisabfrage erstellt: "SELECT * FROM __InstanceCreationEvent WHERE TargetInstance ISA Win32_NTLogEvent GROUP WITHIN 600 BY TargetInstance.SourceName HAVING NumberOfEvents > 15", die aggregierte Ereignisse nur liefert, wenn die Anzahl der Win32_NTLogEvent Ereignisse, die von derselben Quelle empfangen wurden, 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ürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.