WqlEventQuery Construtores

Definição

Inicializa uma nova instância da classe WqlEventQuery.

Sobrecargas

WqlEventQuery()

Inicializa uma nova instância da classe WqlEventQuery. Esse é o construtor sem parâmetros.

WqlEventQuery(String)

Inicializa uma nova instância da classe WqlEventQuery com base no nome de classe de evento ou cadeia de caracteres de consulta.

WqlEventQuery(String, String)

Inicializa uma nova instância da classe WqlEventQuery para o nome de classe de eventos especificado, com a condição especificada.

WqlEventQuery(String, TimeSpan)

Inicializa uma nova instância da classe WqlEventQuery para a classe de evento especificada, com o tempo de latência especificado.

WqlEventQuery(String, String, TimeSpan)

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, a condição e o intervalo de agrupamento especificados.

WqlEventQuery(String, TimeSpan, String)

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, o intervalo de sondagem e a condição especificados.

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

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, a condição, o intervalo de agrupamento e as propriedades de agrupamento especificados.

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

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, a condição, o intervalo de agrupamento, as propriedades de agrupamento e o número de eventos especificados.

WqlEventQuery()

Inicializa uma nova instância da classe WqlEventQuery. Esse é o construtor sem parâmetros.

public:
 WqlEventQuery();
public WqlEventQuery ();
Public Sub New ()

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a

WqlEventQuery(String)

Inicializa uma nova instância da classe WqlEventQuery com base no nome de classe de evento ou cadeia de caracteres de consulta.

public:
 WqlEventQuery(System::String ^ queryOrEventClassName);
public WqlEventQuery (string queryOrEventClassName);
new System.Management.WqlEventQuery : string -> System.Management.WqlEventQuery
Public Sub New (queryOrEventClassName As String)

Parâmetros

queryOrEventClassName
String

A cadeia de caracteres que representa a consulta de evento completa ou o nome da classe de evento a ser consultado. O objeto tentará analisar a cadeia de caracteres como uma consulta de evento válido. Se não houver êxito, o analisador assumirá que o parâmetro representa um nome de classe de evento.

Exemplos

O exemplo a seguir inicializa um WqlEventQuery especificando uma consulta e, em seguida, inicializa um WqlEventQuery especificando um 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

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a

WqlEventQuery(String, String)

Inicializa uma nova instância da classe WqlEventQuery para o nome de classe de eventos especificado, com a condição especificada.

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)

Parâmetros

eventClassName
String

O nome da classe de evento a ser consultada.

condition
String

A condição a ser aplicada a eventos da classe especificada.

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a

WqlEventQuery(String, TimeSpan)

Inicializa uma nova instância da classe WqlEventQuery para a classe de evento especificada, com o tempo de latência especificado.

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)

Parâmetros

eventClassName
String

O nome da classe de evento a ser consultada.

withinInterval
TimeSpan

Um valor de TimeSpan que especifica a latência aceitável para receber esse evento. Esse valor é usado em casos em que não há nenhum provedor de eventos explícito para a consulta solicitada e a WMI é necessária para sondar a condição. Este intervalo é o período máximo de tempo que pode ser decorrido antes que um evento de notificação precise ser entregue.

Exemplos

O exemplo a seguir inicializa um WqlEventQuery especificando um evento e um valor de intervalo de tempo especificando a latência aceitável para receber esse 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

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a

WqlEventQuery(String, String, TimeSpan)

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, a condição e o intervalo de agrupamento especificados.

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)

Parâmetros

eventClassName
String

O nome da classe de evento a ser consultada.

condition
String

A condição a ser aplicada a eventos da classe especificada.

groupWithinInterval
TimeSpan

O intervalo especificado em que a WMI envia um evento agregado, em vez de vários eventos.

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a

WqlEventQuery(String, TimeSpan, String)

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, o intervalo de sondagem e a condição especificados.

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)

Parâmetros

eventClassName
String

O nome da classe de evento a ser consultada.

withinInterval
TimeSpan

Um valor de TimeSpan que especifica a latência aceitável para receber esse evento. Esse valor é usado em casos em que não há nenhum provedor de eventos explícito para a consulta solicitada e a WMI é necessária para sondar a condição. Este intervalo é o período máximo de tempo que pode ser decorrido antes que um evento de notificação precise ser entregue.

condition
String

A condição a ser aplicada a eventos da classe especificada.

Exemplos

O exemplo a seguir cria a consulta de evento: "SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA Win32_Service", que envia a notificação da criação de instâncias Win32_Service , com um intervalo de sondagem de 10 segundos.

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

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a

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

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, a condição, o intervalo de agrupamento e as propriedades de agrupamento especificados.

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

Parâmetros

eventClassName
String

O nome da classe de evento a ser consultada.

condition
String

A condição a ser aplicada a eventos da classe especificada.

groupWithinInterval
TimeSpan

O intervalo especificado em que a WMI envia um evento agregado, em vez de vários eventos.

groupByPropertyList
String[]

As propriedades na classe de evento pela qual os eventos devem ser agrupados.

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a

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

Inicializa uma nova instância da classe WqlEventQuery com o nome de classe de evento, a condição, o intervalo de agrupamento, as propriedades de agrupamento e o número de eventos especificados.

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)

Parâmetros

eventClassName
String

O nome da classe de evento na qual a consulta ocorrerá.

withinInterval
TimeSpan

Um valor de TimeSpan que especifica a latência aceitável para receber esse evento. Esse valor é usado em casos em que não há nenhum provedor de eventos explícito para a consulta solicitada e a WMI é necessária para sondar a condição. Este intervalo é o período máximo de tempo que pode ser decorrido antes que um evento de notificação precise ser entregue.

condition
String

A condição a ser aplicada a eventos da classe especificada.

groupWithinInterval
TimeSpan

O intervalo especificado em que a WMI envia um evento agregado, em vez de vários eventos.

groupByPropertyList
String[]

As propriedades na classe de evento pela qual os eventos devem ser agrupados.

havingCondition
String

A condição a ser aplicada ao número de eventos.

Exemplos

O exemplo a seguir cria a consulta de evento: "SELECT * FROM __InstanceCreationEvent WHERE TargetInstance ISA Win32_NTLogEvent GROUP WITHIN 600 BY TargetInstance.SourceName HAVING NumberOfEvents > 15" que fornece eventos agregados somente se o número de eventos Win32_NTLogEvent recebidos da mesma fonte exceder 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

Comentários

Segurança do .NET Framework

Confiança total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Aplica-se a