ManagementEventWatcher Clase

Definición

Se suscribe a notificaciones de eventos temporales basándose en una consulta de eventos especificada.Subscribes to temporary event notifications based on a specified event query.

public ref class ManagementEventWatcher : System::ComponentModel::Component
public class ManagementEventWatcher : System.ComponentModel.Component
type ManagementEventWatcher = class
    inherit Component
Public Class ManagementEventWatcher
Inherits Component
Herencia
ManagementEventWatcher

Ejemplos

En el ejemplo siguiente se muestra cómo el cliente recibe la notificación cuando se crea una instancia de Win32_Process porque se __InstanceCreationEvent la clase de eventos.The following example shows how the client receives notification when an instance of Win32_Process is created because the event class is __InstanceCreationEvent. Para obtener más información, consulte la documentación de instrumental de administración de Windows .For more information, see the Windows Management Instrumentation documentation. El cliente recibe eventos de forma sincrónica tras llamar al método WaitForNextEvent.The client receives events synchronously by calling the WaitForNextEvent method. Para probar este ejemplo, inicie un proceso, como Bloc de notas, mientras se ejecuta el código de ejemplo.This example can be tested by starting a process, such as Notepad, while the example code is running.

using System;
using System.Management;

// This example shows synchronous consumption of events.
// The client is blocked while waiting for events.

public class EventWatcherPolling
{
    public static int Main(string[] args)
    {
        // Create event query to be notified within 1 second of
        // a change in a service
        WqlEventQuery query =
            new WqlEventQuery("__InstanceCreationEvent",
            new TimeSpan(0,0,1),
            "TargetInstance isa \"Win32_Process\"");

        // Initialize an event watcher and subscribe to events
        // that match this query
        ManagementEventWatcher watcher =
            new ManagementEventWatcher();
        watcher.Query = query;
        // times out watcher.WaitForNextEvent in 5 seconds
        watcher.Options.Timeout = new TimeSpan(0,0,5);

        // Block until the next event occurs
        // Note: this can be done in a loop if waiting for
        //        more than one occurrence
        Console.WriteLine(
            "Open an application (notepad.exe) to trigger an event.");
        ManagementBaseObject e = watcher.WaitForNextEvent();

        //Display information from the event
        Console.WriteLine(
            "Process {0} has been created, path is: {1}",
            ((ManagementBaseObject)e
            ["TargetInstance"])["Name"],
            ((ManagementBaseObject)e
            ["TargetInstance"])["ExecutablePath"]);

        //Cancel the subscription
        watcher.Stop();
        return 0;
    }
}
Imports System.Management

' This example shows synchronous consumption of events. 
' The client is blocked while waiting for events. 

Public Class EventWatcherPolling
    Public Overloads Shared Function _
        Main(ByVal args() As String) As Integer

        ' Create event query to be notified within 1 second of 
        ' a change in a service
        Dim query As New WqlEventQuery( _
            "__InstanceCreationEvent", _
            New TimeSpan(0, 0, 1), _
            "TargetInstance isa ""Win32_Process""")

        ' Initialize an event watcher and subscribe to events 
        ' that match this query
        Dim watcher As New ManagementEventWatcher
        watcher.Query = query
        ' times watcher.WaitForNextEvent in 5 seconds
        watcher.Options.Timeout = New TimeSpan(0, 0, 5)

        ' Block until the next event occurs 
        ' Note: this can be done in a loop
        ' if waiting for more than one occurrence
        Console.WriteLine( _
          "Open an application (notepad.exe) to trigger an event.")
        Dim e As ManagementBaseObject = _
            watcher.WaitForNextEvent()

        'Display information from the event
        Console.WriteLine( _
            "Process {0} has created, path is: {1}", _
            CType(e("TargetInstance"), _
                ManagementBaseObject)("Name"), _
            CType(e("TargetInstance"), _
                ManagementBaseObject)("ExecutablePath"))

        'Cancel the subscription
        watcher.Stop()
        Return 0

    End Function 'Main
End Class

Constructores

ManagementEventWatcher()

Inicializa una nueva instancia de la clase ManagementEventWatcher.Initializes a new instance of the ManagementEventWatcher class. Para una posterior inicialización, establezca las propiedades del objeto.For further initialization, set the properties on the object. Este es el constructor sin parámetros.This is the parameterless constructor.

ManagementEventWatcher(EventQuery)

Inicializa una nueva instancia de la clase ManagementEventWatcher cuando se proporciona una consulta de eventos WMI.Initializes a new instance of the ManagementEventWatcher class when given a WMI event query.

ManagementEventWatcher(ManagementScope, EventQuery)

Inicializa una nueva instancia de la clase ManagementEventWatcher que escucha los eventos de acuerdo con la consulta de eventos WMI dada.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query.

ManagementEventWatcher(ManagementScope, EventQuery, EventWatcherOptions)

Inicializa una nueva instancia de la clase ManagementEventWatcher que escucha los eventos de acuerdo con la consulta de eventos WMI dada y las opciones especificadas.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query, according to the specified options. Para esta variante, la consulta y el ámbito son objetos especificados.For this variant, the query and the scope are specified objects. El objeto de opciones puede especificar opciones como un tiempo de espera e información del contexto.The options object can specify options such as time-out and context information.

ManagementEventWatcher(String)

Inicializa una nueva instancia de la clase ManagementEventWatcher cuando se proporciona una consulta de eventos WMI en forma de cadena.Initializes a new instance of the ManagementEventWatcher class when given a WMI event query in the form of a string.

ManagementEventWatcher(String, String)

Inicializa una nueva instancia de la clase ManagementEventWatcher que escucha los eventos de acuerdo con la consulta de eventos WMI dada.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query. Para esta variante, la consulta y el ámbito se especifican como cadenas.For this variant, the query and the scope are specified as strings.

ManagementEventWatcher(String, String, EventWatcherOptions)

Inicializa una nueva instancia de la ManagementEventWatcher clase que escucha los eventos que se ajustan a la consulta de eventos WMI dada, de acuerdo con las opciones especificadas.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query, according to the specified options. Para esta variante, la consulta y el ámbito se especifican como cadenas.For this variant, the query and the scope are specified as strings. El objeto de opciones puede especificar opciones como un tiempo de espera e información del contexto.The options object can specify options such as a time-out and context information.

Propiedades

CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
Container

Obtiene la interfaz IContainer que contiene la clase Component.Gets the IContainer that contains the Component.

(Heredado de Component)
DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
Options

Obtiene o establece las opciones que se utilizan para inspeccionar los eventos.Gets or sets the options used to watch for events.

Query

Obtiene o establece los criterios que se aplicarán a los eventos.Gets or sets the criteria to apply to events.

Scope

Obtiene o establece el ámbito (espacio de nombres) en que se inspeccionarán los eventos.Gets or sets the scope in which to watch for events (namespace or scope).

Site

Obtiene o establece ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)

Métodos

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Heredado de Component)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
Finalize()

Garantiza que se borran las llamadas pendientes.Ensures that outstanding calls are cleared. Es el destructor del objeto.This is the destructor for the object. En C#, los finalizadores se expresan mediante la sintaxis del destructor.In C#, finalizers are expressed using destructor syntax.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()
Obsoleto.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()
Obsoleto.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
Start()

Se suscribe a eventos con la consulta dada y los entrega, asincrónicamente, a través del evento EventArrived.Subscribes to events with the given query and delivers them, asynchronously, through the EventArrived event.

Stop()

Cancela la suscripción, ya sea sincrónica o asincrónica.Cancels the subscription whether it is synchronous or asynchronous.

ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Heredado de Component)
WaitForNextEvent()

Espera al siguiente evento que coincida con la consulta especificada que va a llegar, y lo devuelve.Waits for the next event that matches the specified query to arrive, and then returns it.

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)
EventArrived

Se produce cuando llega un nuevo evento.Occurs when a new event arrives.

Stopped

Se produce cuando se cancela una suscripción.Occurs when a subscription is canceled.

Se aplica a