EventWatcherOptions Klasa

Definicja

Określa opcje dla oglądania zdarzeń zarządzania.Specifies options for management event watching.

public ref class EventWatcherOptions : System::Management::ManagementOptions
public class EventWatcherOptions : System.Management.ManagementOptions
type EventWatcherOptions = class
    inherit ManagementOptions
Public Class EventWatcherOptions
Inherits ManagementOptions
Dziedziczenie
EventWatcherOptions

Przykłady

Poniższy przykład pokazuje, jak klient otrzymuje powiadomienie po utworzeniu wystąpienia elementu Win32_Process , ponieważ klasa zdarzenia to __InstanceCreationEvent.The following example shows how the client receives notification when an instance of Win32_Process is created because the event class is __InstanceCreationEvent. Aby uzyskać więcej informacji, zobacz dokumentację Instrumentacja zarządzania Windows .For more information, see the Windows Management Instrumentation documentation. Klient odbiera zdarzenia synchronicznie przez wywołanie WaitForNextEvent metody.The client receives events synchronously by calling the WaitForNextEvent method. Ten przykład może być testowany przez uruchomienie procesu, takiego jak Notatnik, podczas gdy przykładowy kod jest uruchomiony.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
        string query = "SELECT * FROM" +
            " __InstanceCreationEvent WITHIN 1 " + 
            "WHERE TargetInstance isa \"Win32_Process\"";

        // Event options
        EventWatcherOptions eventOptions = new
            EventWatcherOptions();
        eventOptions.Timeout = System.TimeSpan.MaxValue;

        // Initialize an event watcher and subscribe to events 
        // that match this query
        ManagementEventWatcher watcher =
            new ManagementEventWatcher("root\\CIMV2", query,
            eventOptions);
      
        // 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 String
        query = "SELECT * FROM" & _
            " __InstanceCreationEvent WITHIN 1 " & _
            "WHERE TargetInstance isa ""Win32_Process"""

        ' Event options
        Dim eventOptions As New EventWatcherOptions
        eventOptions.Timeout = System.TimeSpan.MaxValue

        ' Initialize an event watcher and subscribe to events 
        ' that match this query
        Dim watcher As New ManagementEventWatcher( _
            "root\CIMV2", query, eventOptions)

        ' 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

Konstruktory

EventWatcherOptions()

Inicjuje nowe wystąpienie EventWatcherOptions klasy do obserwowania zdarzenia przy użyciu wartości domyślnych.Initializes a new instance of the EventWatcherOptions class for event watching, using default values. To jest Konstruktor bez parametrów.This is the parameterless constructor.

EventWatcherOptions(ManagementNamedValueCollection, TimeSpan, Int32)

Inicjuje nowe wystąpienie EventWatcherOptions klasy za pomocą podanej wartości.Initializes a new instance of the EventWatcherOptions class with the given values.

Właściwości

BlockSize

Pobiera lub ustawia rozmiar bloku dla operacji blokowania.Gets or sets the block size for block operations. Podczas oczekiwania na zdarzenia, ta wartość określa, ile zdarzeń czekać przed zwróceniem.When waiting for events, this value specifies how many events to wait for before returning.

Context

Pobiera lub ustawia obiekt kontekstu WMI.Gets or sets a WMI context object. Jest to lista par nazwa-wartość, która ma zostać przeniesiona do dostawcy WMI, który obsługuje informacje kontekstu dla niestandardowej operacji.This is a name-value pairs list to be passed through to a WMI provider that supports context information for customized operation.

(Odziedziczone po ManagementOptions)
Timeout

Pobiera lub ustawia limit czasu, który ma zostać zastosowany do operacji.Gets or sets the time-out to apply to the operation. Należy pamiętać, że w przypadku operacji, które zwracają kolekcje, ten limit czasu ma zastosowanie do wyliczenia za pomocą wynikowej kolekcji, a nie ReturnImmediately samej operacji (właściwość jest używana dla tej ostatniej).Note that for operations that return collections, this time-out applies to the enumeration through the resulting collection, not the operation itself (the ReturnImmediately property is used for the latter). Ta właściwość służy do wskazywania, że operacja powinna zostać wykonana częściowo synchronicznie.This property is used to indicate that the operation should be performed semi-synchronously.

(Odziedziczone po ManagementOptions)

Metody

Clone()

Zwraca kopię obiektu.Returns a copy of the object.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy