ManagementEventWatcher ManagementEventWatcher ManagementEventWatcher ManagementEventWatcher Class

Определение

Осуществляет подписку на временные уведомления о событиях в соответствии с заданным запросом событий.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
Наследование
ManagementEventWatcherManagementEventWatcherManagementEventWatcherManagementEventWatcher

Примеры

В следующем примере показано, как клиент получает уведомление при создании экземпляра Win32_Process , так как класс событий — __InstanceCreationEvent.The following example shows how the client receives notification when an instance of Win32_Process is created because the event class is __InstanceCreationEvent. Дополнительные сведения см. в документации по инструментарий управления Windows (WMI) .For more information, see the Windows Management Instrumentation documentation. Клиент получает события синхронно, вызывая метод WaitForNextEvent.The client receives events synchronously by calling the WaitForNextEvent method. Чтобы протестировать этот пример, можно во время выполнения кода запустить какой-нибудь процесс, такой как приложение Блокнот.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

Конструкторы

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

Инициализирует новый экземпляр класса ManagementEventWatcher.Initializes a new instance of the ManagementEventWatcher class. Для дальнейшей инициализации следует задать свойства объекта.For further initialization, set the properties on the object. Это конструктор без параметров.This is the parameterless constructor.

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

Инициализирует новый экземпляр класса ManagementEventWatcher при наличии запроса WMI-события.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)

Инициализирует новый экземпляр ManagementEventWatcher, который прослушивает события, удовлетворяющие данному запросу WMI-событий.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)

Выполняет инициализацию нового экземпляра класса ManagementEventWatcher, который прослушивает события, удовлетворяющие данному запросу WMI-событий в соответствии с заданными параметрами.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query, according to the specified options. Для этого варианта запрос и область представляют собой настраиваемые объекты.For this variant, the query and the scope are specified objects. Параметрический объект может задавать такие параметры, как время ожидания и контекст.The options object can specify options such as time-out and context information.

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

Инициализирует новый экземпляр класса ManagementEventWatcher, если данный запрос WMI-событий представлен в виде строки.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)

Инициализирует новый экземпляр ManagementEventWatcher, который прослушивает события, удовлетворяющие данному запросу WMI-событий.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query. Для этого варианта запрос и область задаются в виде строк.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)

Инициализирует новый экземпляр класса ManagementEventWatcher, который прослушивает события, удовлетворяющие данному запросу WMI-событий в соответствии с заданными параметрами.Initializes a new instance of the ManagementEventWatcher class that listens for events conforming to the given WMI event query, according to the specified options. Для этого варианта запрос и область задаются в виде строк.For this variant, the query and the scope are specified as strings. Параметрический объект может задавать такие параметры, как время ожидания и контекст.The options object can specify options such as a time-out and context information.

Свойства

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Options Options Options Options

Получает или задает параметры отслеживания событий.Gets or sets the options used to watch for events.

Query Query Query Query

Получает или задает критерии, которым должны отвечать события.Gets or sets the criteria to apply to events.

Scope Scope Scope Scope

Получает или задает область (или пространство имен), в которой необходимо отслеживать события.Gets or sets the scope in which to watch for events (namespace or scope).

Site Site Site Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Inherited from Component)

Методы

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

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.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()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

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

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.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)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Обеспечивает очистку всех незавершенных вызовов.Ensures that outstanding calls are cleared. Это деструктор объекта.This is the destructor for the object. В C# для выражения методов завершения используется синтаксис деструктора.In C#, finalizers are expressed using destructor syntax.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.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)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

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

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

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

Осуществляет подписку на события, удовлетворяющие данному запросу, и доставляет их в асинхронном режиме с помощью события EventArrived.Subscribes to events with the given query and delivers them, asynchronously, through the EventArrived event.

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

Отменяет подписку, независимо от того, является ли она синхронной или асинхронной.Cancels the subscription whether it is synchronous or asynchronous.

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

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

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

Ожидает следующего события, которое удовлетворяет заданному запросу, а затем возвращает это событие.Waits for the next event that matches the specified query to arrive, and then returns it.

События

Disposed Disposed Disposed Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
EventArrived EventArrived EventArrived EventArrived

Происходит, когда возникает новое событие.Occurs when a new event arrives.

Stopped Stopped Stopped Stopped

Происходит, когда отменяется подписка.Occurs when a subscription is canceled.

Применяется к