WqlEventQuery 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 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()
初始化 WqlEventQuery 類別的新執行個體。 這是無參數建構函式。
public:
WqlEventQuery();
public WqlEventQuery ();
Public Sub New ()
備註
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
WqlEventQuery(String)
根據指定的查詢字串或事件類別名稱,初始化 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)
使用指定條件,為指定事件類別名稱初始化 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)
使用指定延遲時間,為指定事件類別初始化 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)
使用指定的事件類別名稱、條件和群組間隔,初始化 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)
使用指定的事件類別名稱、輪詢間隔和條件,初始化 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[])
使用指定的事件類別名稱、條件、群組間隔和群組屬性,初始化 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)
使用指定的事件類別名稱、條件、群組間隔、群組屬性和指定的事件數目,初始化 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 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。