WqlEventQuery Costruttori

Definizione

Spazio dei nomi:

System.Management

Assembly:

System.Management.dll

Pacchetto:

System.Management v8.0.0

Inizializza una nuova istanza della classe WqlEventQuery.

Overload

WqlEventQuery()	Inizializza una nuova istanza della classe WqlEventQuery. Si tratta del costruttore senza parametri.
WqlEventQuery(String)	Inizializza una nuova istanza della classe WqlEventQuery in base alla stringa di query o al nome della classe di eventi specificati.
WqlEventQuery(String, String)	Inizializza una nuova istanza della classe WqlEventQuery per il nome della classe di eventi specificato, con la condizione specificata.
WqlEventQuery(String, TimeSpan)	Inizializza una nuova istanza della classe WqlEventQuery per la classe di eventi specificata, con il tempo di latenza specificato.
WqlEventQuery(String, String, TimeSpan)	Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, la condizione e l'intervallo di raggruppamento specificati.
WqlEventQuery(String, TimeSpan, String)	Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, l'intervallo di polling e la condizione specificati.
WqlEventQuery(String, String, TimeSpan, String[])	Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, la condizione, l'intervallo di raggruppamento e le proprietà di raggruppamento specificati.
WqlEventQuery(String, TimeSpan, String, TimeSpan, String[], String)	Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, la condizione, l'intervallo di raggruppamento, le proprietà di raggruppamento e il numero di eventi specificati.

WqlEventQuery()

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery. Si tratta del costruttore senza parametri.

public:
 WqlEventQuery();

public WqlEventQuery ();

Public Sub New ()

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.

WqlEventQuery(String)

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery in base alla stringa di query o al nome della classe di eventi specificati.

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

public WqlEventQuery (string queryOrEventClassName);

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

Public Sub New (queryOrEventClassName As String)

Parametri

queryOrEventClassName

String

Stringa che rappresenta l'intera query di evento oppure nome della classe di eventi da ricercare. L'oggetto tenterà di analizzare la stringa come una query di eventi valida. Se l'operazione non ha esito positivo, l'analizzatore presupporrà che il parametro rappresenti un nome di classe di eventi.

Esempio

Nell'esempio seguente viene inizializzato un WqlEventQuery oggetto specificando una query e quindi inizializza un WqlEventQuery oggetto specificando un evento.

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

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.

WqlEventQuery(String, String)

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery per il nome della classe di eventi specificato, con la condizione specificata.

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)

Parametri

eventClassName

String

Nome della classe di eventi da ricercare.

condition

String

Condizione da applicare agli eventi della classe specificata.

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.

WqlEventQuery(String, TimeSpan)

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery per la classe di eventi specificata, con il tempo di latenza specificato.

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)

Parametri

eventClassName

String

Nome della classe di eventi da ricercare.

withinInterval

TimeSpan

Valore TimeSpan che specifica la latenza accettabile per la ricezione dell'evento. Il valore è utilizzato nei casi in cui non è disponibile un provider di eventi esplicito per la query richiesta e WMI deve eseguire il polling della condizione. Questo intervallo rappresenta il tempo massimo che può trascorrere prima della consegna della notifica di un evento.

Esempio

Nell'esempio seguente viene inizializzato un WqlEventQuery oggetto specificando un evento e un valore di intervallo di tempo che specifica la latenza accettabile per la ricezione di questo evento.

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

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.

WqlEventQuery(String, String, TimeSpan)

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, la condizione e l'intervallo di raggruppamento specificati.

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)

Parametri

eventClassName

String

Nome della classe di eventi da ricercare.

condition

String

Condizione da applicare agli eventi della classe specificata.

groupWithinInterval

TimeSpan

Intervallo specificato in corrispondenza del quale WMI invia un aggregate eventoggetto anziché molti eventi.

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.

WqlEventQuery(String, TimeSpan, String)

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, l'intervallo di polling e la condizione specificati.

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)

Parametri

eventClassName

String

Nome della classe di eventi da ricercare.

withinInterval

TimeSpan

Valore TimeSpan che specifica la latenza accettabile per la ricezione dell'evento. Il valore è utilizzato nei casi in cui non è disponibile un provider di eventi esplicito per la query richiesta e WMI deve eseguire il polling della condizione. Questo intervallo rappresenta il tempo massimo che può trascorrere prima della consegna della notifica di un evento.

condition

String

Condizione da applicare agli eventi della classe specificata.

Esempio

Nell'esempio seguente viene creata la query di evento : "SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA Win32_Service ", che invia una notifica della creazione di istanze di Win32_Service , con un intervallo di polling di 10 secondi.

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

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.

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

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, la condizione, l'intervallo di raggruppamento e le proprietà di raggruppamento specificati.

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

Parametri

eventClassName

String

Nome della classe di eventi da ricercare.

condition

String

Condizione da applicare agli eventi della classe specificata.

groupWithinInterval

TimeSpan

Intervallo specificato in corrispondenza del quale WMI invia un aggregate eventoggetto anziché molti eventi.

groupByPropertyList

String[]

Proprietà nella classe di eventi in base alle quali gli eventi dovrebbero essere raggruppati.

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.

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

Origine:

ManagementQuery.cs

Inizializza una nuova istanza della classe WqlEventQuery con il nome della classe di eventi, la condizione, l'intervallo di raggruppamento, le proprietà di raggruppamento e il numero di eventi specificati.

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)

Parametri

eventClassName

String

Nome della classe di eventi da ricercare.

withinInterval

TimeSpan

Valore TimeSpan che specifica la latenza accettabile per la ricezione dell'evento. Il valore è utilizzato nei casi in cui non è disponibile un provider di eventi esplicito per la query richiesta e WMI deve eseguire il polling della condizione. Questo intervallo rappresenta il tempo massimo che può trascorrere prima della consegna della notifica di un evento.

condition

String

Condizione da applicare agli eventi della classe specificata.

groupWithinInterval

TimeSpan

Intervallo specificato in corrispondenza del quale WMI invia un aggregate eventoggetto anziché molti eventi.

groupByPropertyList

String[]

Proprietà nella classe di eventi in base alle quali gli eventi dovrebbero essere raggruppati.

havingCondition

String

Condizione da applicare al numero di eventi.

Esempio

Nell'esempio seguente viene creata la query di evento: "SELECT * FROM __InstanceCreationEvent WHERE TargetInstance ISA Win32_NTLogEvent GROUP WITHIN 600 BY TargetInstance.SourceName HAVING NumberOfEvents > 15" che fornisce eventi aggregati solo se il numero di eventi Win32_NTLogEvent ricevuti dalla stessa origine supera 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

Commenti

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Uso di librerie da codice parzialmente attendibile.