ManagementEventWatcher ManagementEventWatcher ManagementEventWatcher ManagementEventWatcher Class

Definition

Abonniert die temporären Ereignisbenachrichtigungen basierend auf einer angegebenen Ereignisabfrage.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
Vererbung
ManagementEventWatcherManagementEventWatcherManagementEventWatcherManagementEventWatcher

Beispiele

Das folgende Beispiel zeigt, wie der Client eine Benachrichtigung empfängt, wenn eine Instanz von Win32_Process erstellt wird, da die-Ereignisklasse __InstanceCreationEventist.The following example shows how the client receives notification when an instance of Win32_Process is created because the event class is __InstanceCreationEvent. Weitere Informationen finden Sie in der Windows-Verwaltungsinstrumentation -Dokumentation.For more information, see the Windows Management Instrumentation documentation. Der Client empfängt Ereignisse synchron durch Aufrufen der WaitForNextEvent-Methode.The client receives events synchronously by calling the WaitForNextEvent method. Während der Beispielcode ausgeführt wird, kann dieses Beispiel durch Starten eines Prozesses wie Editor getestet werden.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 'EventWatcherPolling

Konstruktoren

ManagementEventWatcher() ManagementEventWatcher() ManagementEventWatcher() ManagementEventWatcher()

Initialisiert eine neue Instanz der ManagementEventWatcher-Klasse.Initializes a new instance of the ManagementEventWatcher class. Legen Sie für die weitere Initialisierung die Eigenschaften für das Objekt fest.For further initialization, set the properties on the object. Dies ist der parameterlose Konstruktor.This is the parameterless constructor.

ManagementEventWatcher(EventQuery) ManagementEventWatcher(EventQuery) ManagementEventWatcher(EventQuery) ManagementEventWatcher(EventQuery)

Initialisiert eine neue Instanz der ManagementEventWatcher-Klasse, wenn eine WMI-Ereignisabfrage angegeben ist.Initializes a new instance of the ManagementEventWatcher class when given a WMI event query.

ManagementEventWatcher(ManagementScope, EventQuery) ManagementEventWatcher(ManagementScope, EventQuery) ManagementEventWatcher(ManagementScope, EventQuery) ManagementEventWatcher(ManagementScope, EventQuery)

Initialisiert eine neue Instanz der ManagementEventWatcher-Klasse, die Ereignisse überwacht, die mit der angegebenen WMI-Ereignisabfrage übereinstimmen.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query.

ManagementEventWatcher(ManagementScope, EventQuery, EventWatcherOptions) ManagementEventWatcher(ManagementScope, EventQuery, EventWatcherOptions) ManagementEventWatcher(ManagementScope, EventQuery, EventWatcherOptions) ManagementEventWatcher(ManagementScope, EventQuery, EventWatcherOptions)

Initialisiert eine neue Instanz der ManagementEventWatcher-Klasse, die auf Ereignisse lauscht, die mit der angegebenen WMI-Ereignisabfrage gemäß den angegebenen Optionen übereinstimmen.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query, according to the specified options. Bei dieser Variante sind die Abfrage und der Gültigkeitsbereich angegebene Objekte.For this variant, the query and the scope are specified objects. Das Optionsobjekt kann Optionen angeben, z. B. Timeout- und Kontextinformationen.The options object can specify options such as time-out and context information.

ManagementEventWatcher(String) ManagementEventWatcher(String) ManagementEventWatcher(String) ManagementEventWatcher(String)

Initialisiert eine neue Instanz der ManagementEventWatcher-Klasse, wenn eine WMI-Ereignisabfrage in Form einer Zeichenabfolge vorhanden ist.Initializes a new instance of the ManagementEventWatcher class when given a WMI event query in the form of a string.

ManagementEventWatcher(String, String) ManagementEventWatcher(String, String) ManagementEventWatcher(String, String) ManagementEventWatcher(String, String)

Initialisiert eine neue Instanz der ManagementEventWatcher-Klasse, die Ereignisse überwacht, die mit der angegebenen WMI-Ereignisabfrage übereinstimmen.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query. Bei dieser Variante werden die Abfrage und der Gültigkeitsbereich als Zeichenfolgen angegeben.For this variant, the query and the scope are specified as strings.

ManagementEventWatcher(String, String, EventWatcherOptions) ManagementEventWatcher(String, String, EventWatcherOptions) ManagementEventWatcher(String, String, EventWatcherOptions) ManagementEventWatcher(String, String, EventWatcherOptions)

Initialisiert eine neue Instanz der ManagementEventWatcher-Klasse, die Ereignisse überwacht, die mit der angegebenen WMI-Ereignisabfrage gemäß den angegebenen Optionen übereinstimmen.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query, according to the specified options. Bei dieser Variante werden die Abfrage und der Gültigkeitsbereich als Zeichenfolgen angegeben.For this variant, the query and the scope are specified as strings. Das Optionsobjekt kann Optionen angeben, z. B. Timeout- und Kontextinformationen.The options object can specify options such as a time-out and context information.

Eigenschaften

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Options Options Options Options

Ruft die Optionen für das Überwachen von Ereignissen ab oder legt diese fest.Gets or sets the options used to watch for events.

Query Query Query Query

Ruft die für die Ereignisse geltenden Kriterien ab oder legt diese fest.Gets or sets the criteria to apply to events.

Scope Scope Scope Scope

Ruft den Bereich ab, in dem Ereignisse überwacht werden sollen (Namespace oder Gültigkeitsbereich), oder legt diesen fest.Gets or sets the scope in which to watch for events (namespace or scope).

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)

Methoden

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Stellt sicher, dass unerledigte Aufrufe gelöscht werden.Ensures that outstanding calls are cleared. Dies ist der Destruktor für das Objekt.This is the destructor for the object. In C# werden Finalizer mit Destruktorsyntax angegeben.In C#, finalizers are expressed using destructor syntax.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Start() Start() Start() Start()

Abonniert mit der angegebenen Abfrage Ereignisse und übermittelt sie asynchron über das EventArrived-Ereignis.Subscribes to events with the given query and delivers them, asynchronously, through the EventArrived event.

Stop() Stop() Stop() Stop()

Hebt das Abonnement auf, unabhängig davon, ob es synchron oder asynchron ist.Cancels the subscription whether it is synchronous or asynchronous.

ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)
WaitForNextEvent() WaitForNextEvent() WaitForNextEvent() WaitForNextEvent()

Wartet auf das Eintreffen des nächsten Ereignisses, das mit der angegebenen Abfrage übereinstimmt, und gibt es anschließend zurück.Waits for the next event that matches the specified query to arrive, and then returns it.

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
EventArrived EventArrived EventArrived EventArrived

Tritt beim Eintreffen eines neuen Ereignisses ein.Occurs when a new event arrives.

Stopped Stopped Stopped Stopped

Tritt ein, wenn ein Abonnement aufgehoben wird.Occurs when a subscription is canceled.

Gilt für: