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 Management Instrumentation 설명서.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
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

생성자

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 default constructor.

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

WMI 이벤트 쿼리에 따라 ManagementEventWatcher 클래스의 새 인스턴스를 초기화합니다.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)

지정된 WMI 이벤트 쿼리와 일치하는 이벤트를 수신하는 ManagementEventWatcher 클래스의 새 인스턴스를 초기화합니다.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)

지정된 옵션에 따라, 지정된 WMI 이벤트 쿼리와 일치하는 이벤트를 수신하는 ManagementEventWatcher 클래스의 새 인스턴스를 초기화합니다.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)

WMI 이벤트 쿼리가 문자열 형태로 지정되면 ManagementEventWatcher 클래스의 새 인스턴스를 초기화합니다.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)

지정된 WMI 이벤트 쿼리와 일치하는 이벤트를 수신하는 ManagementEventWatcher 클래스의 새 인스턴스를 초기화합니다.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)

지정된 옵션에 따라, 지정된 WMI 이벤트 쿼리와 일치하는 이벤트를 수신하는 ManagementEventWatcher 클래스의 새 인스턴스를 초기화합니다.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

ComponentISite를 가져오거나 설정합니다.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()

Component의 이름이 포함된 String을 반환합니다(있는 경우).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.

적용 대상