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
| 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
- 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ü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.
Gilt für:
WqlEventQuery(String)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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.WqlEventQueryPublic 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.
Gilt für:
WqlEventQuery(String, String)
- 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.WqlEventQueryPublic 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.
Gilt für:
WqlEventQuery(String, TimeSpan)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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.WqlEventQueryPublic 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.
Gilt für:
WqlEventQuery(String, String, TimeSpan)
- 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.WqlEventQueryPublic 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.
Gilt für:
WqlEventQuery(String, TimeSpan, String)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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.WqlEventQueryPublic 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.
Gilt für:
WqlEventQuery(String, String, TimeSpan, String[])
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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.WqlEventQueryPublic 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.
Gilt für:
WqlEventQuery(String, TimeSpan, String, TimeSpan, String[], String)
- Quelle:
- ManagementQuery.cs
- Quelle:
- ManagementQuery.cs
- 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.WqlEventQueryPublic 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.
