ManagementEventWatcher Kelas

Definisi

Ruang nama:

System.Management

Rakitan:

System.Management.dll

Paket:

System.Management v8.0.0

Sumber:

ManagementEventWatcher.cs

Berlangganan pemberitahuan peristiwa sementara berdasarkan kueri peristiwa tertentu.

public ref class ManagementEventWatcher : System::ComponentModel::Component

public class ManagementEventWatcher : System.ComponentModel.Component

type ManagementEventWatcher = class
    inherit Component

Public Class ManagementEventWatcher
Inherits Component

Warisan

Object

MarshalByRefObject

Component

ManagementEventWatcher

Contoh

Contoh berikut menunjukkan bagaimana klien menerima pemberitahuan saat instans Win32_Process dibuat karena kelas peristiwa __InstanceCreationEvent. Untuk informasi selengkapnya, lihat dokumentasi Instrumentasi Manajemen Windows . Klien menerima peristiwa secara sinkron dengan memanggil WaitForNextEvent metode . Contoh ini dapat diuji dengan memulai proses, seperti Notepad, saat kode contoh sedang berjalan.

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

Konstruktor

ManagementEventWatcher()	Menginisialisasi instans baru kelas ManagementEventWatcher. Untuk inisialisasi lebih lanjut, atur properti pada objek . Ini adalah konstruktor tanpa parameter.
ManagementEventWatcher(EventQuery)	Menginisialisasi instans ManagementEventWatcher baru kelas saat diberi kueri peristiwa WMI.
ManagementEventWatcher(ManagementScope, EventQuery)	Menginisialisasi instans ManagementEventWatcher baru kelas yang mendengarkan peristiwa yang sesuai dengan kueri peristiwa WMI yang diberikan.
ManagementEventWatcher(ManagementScope, EventQuery, EventWatcherOptions)	Menginisialisasi instans ManagementEventWatcher baru kelas yang mendengarkan peristiwa yang sesuai dengan kueri peristiwa WMI yang diberikan, sesuai dengan opsi yang ditentukan. Untuk varian ini, kueri dan cakupan adalah objek yang ditentukan. Objek opsi dapat menentukan opsi seperti waktu habis dan informasi konteks.
ManagementEventWatcher(String)	Menginisialisasi instans ManagementEventWatcher baru kelas saat diberi kueri peristiwa WMI dalam bentuk string.
ManagementEventWatcher(String, String)	Menginisialisasi instans ManagementEventWatcher baru kelas yang mendengarkan peristiwa yang sesuai dengan kueri peristiwa WMI yang diberikan. Untuk varian ini, kueri dan cakupan ditentukan sebagai string.
ManagementEventWatcher(String, String, EventWatcherOptions)	Menginisialisasi instans ManagementEventWatcher baru kelas yang mendengarkan peristiwa yang sesuai dengan kueri peristiwa WMI yang diberikan, sesuai dengan opsi yang ditentukan. Untuk varian ini, kueri dan cakupan ditentukan sebagai string. Objek opsi dapat menentukan opsi seperti informasi waktu habis dan konteks.

Properti

CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
Options	Mendapatkan atau mengatur opsi yang digunakan untuk watch peristiwa.
Query	Mendapatkan atau menetapkan kriteria untuk diterapkan ke peristiwa.
Scope	Mendapatkan atau mengatur cakupan untuk watch peristiwa (namespace atau cakupan).
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)

Metode

CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Component dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	Memastikan bahwa panggilan yang luar biasa dibersihkan. Ini adalah destruktor untuk objek . Dalam C#, finalizer diekspresikan menggunakan sintaks destruktor.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
Start()	Berlangganan peristiwa dengan kueri yang diberikan dan mengirimkannya, secara asinkron, melalui EventArrived peristiwa.
Stop()	Membatalkan langganan baik itu sinkron atau asinkron.
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)
WaitForNextEvent()	Menunggu peristiwa berikutnya yang cocok dengan kueri yang ditentukan tiba, lalu mengembalikannya.

Acara

Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
EventArrived	Terjadi ketika peristiwa baru tiba.
Stopped	Terjadi saat langganan dibatalkan.