ManagementOperationObserver.ObjectReady Événement

Définition

Espace de noms:

System.Management

Assembly:

System.Management.dll

Se produit lorsqu'un nouvel objet est disponible.

public:
 event System::Management::ObjectReadyEventHandler ^ ObjectReady;

public event System.Management.ObjectReadyEventHandler ObjectReady;

member this.ObjectReady : System.Management.ObjectReadyEventHandler 

Public Custom Event ObjectReady As ObjectReadyEventHandler 

Public Event ObjectReady As ObjectReadyEventHandler 

Type d'événement

ObjectReadyEventHandler

Exemples

L’exemple suivant montre comment effectuer une énumération d’instance asynchrone. L’exemple utilise la ManagementOperationObserver classe pour gérer les informations de gestion et les événements de manière asynchrone.

using System;
using System.Management;

// This example demonstrates how
// to perform an asynchronous instance enumeration.

public class EnumerateInstancesAsync
{
    public EnumerateInstancesAsync()
    {
        // Enumerate asynchronously using Object Searcher
        // ===============================================

        // Instantiate an object searcher with the query
        ManagementObjectSearcher searcher =
            new ManagementObjectSearcher(new
            SelectQuery("Win32_Service"));

        // Create a results watcher object,
        // and handler for results and completion
        ManagementOperationObserver results = new
            ManagementOperationObserver();

        // Attach handler to events for results and completion
        results.ObjectReady += new
            ObjectReadyEventHandler(this.NewObject);
        results.Completed += new
            CompletedEventHandler(this.Done);

        // Call the asynchronous overload of Get()
        // to start the enumeration
        searcher.Get(results);

        // Do something else while results
        // arrive asynchronously
        while (!this.Completed)
        {
            System.Threading.Thread.Sleep (1000);
        }

        this.Reset();
    }

    private bool isCompleted = false;

    private void NewObject(object sender,
        ObjectReadyEventArgs obj)
    {
        Console.WriteLine("Service : {0}, State = {1}",
            obj.NewObject["Name"],
            obj.NewObject["State"]);
    }

    private bool Completed
    {
        get
        {
            return isCompleted;
        }
    }

    private void Reset()
    {
        isCompleted = false;
    }

    private void Done(object sender,
        CompletedEventArgs obj)
    {
        isCompleted = true;
    }

    public static void Main()
    {
        EnumerateInstancesAsync example =
            new EnumerateInstancesAsync();

        return;
    }
}

Imports System.Management

' This example demonstrates how
' to perform an asynchronous instance enumeration.

Public Class EnumerateInstancesAsync

    Public Sub New()

        Me.isCompleted = False

        ' Enumerate asynchronously using Object Searcher
        ' ===============================================

        ' Instantiate an object searcher with the query
        Dim searcher As ManagementObjectSearcher
        searcher = New ManagementObjectSearcher( _
            New SelectQuery("Win32_Service"))

        ' Create a results watcher object, 
        ' and handler for results and completion
        Dim results As ManagementOperationObserver
        results = New ManagementOperationObserver

        ' Attach handler to events for
        ' results and completion
        AddHandler results.ObjectReady, _
            AddressOf Me.NewObject
        AddHandler results.Completed, _
            AddressOf Me.Done

        ' Call the asynchronous overload of
        ' Get() to start the enumeration
        searcher.Get(results)

        ' Do something else while results 
        ' arrive(asynchronously)
        Do While (Me.Completed.Equals(False))

            System.Threading.Thread.Sleep(1000)
        Loop

        Me.Reset()

    End Sub

    Private isCompleted As Boolean

    Private Sub NewObject(ByVal sender As Object, _
        ByVal e As ObjectReadyEventArgs)

        Console.WriteLine("Service : {0}, State = {1}", _
         e.NewObject("Name"), e.NewObject("State"))
    End Sub

    Private ReadOnly Property Completed() As Boolean
        Get
            Return isCompleted
        End Get
    End Property

    Private Sub Reset()

        isCompleted = False
    End Sub

    Private Sub Done(ByVal sender As Object, _
        ByVal e As CompletedEventArgs)

        isCompleted = True
    End Sub


    Public Shared Function _
        Main(ByVal args() As String) As Integer

        Dim example As New EnumerateInstancesAsync

        Return 0

    End Function

End Class

Remarques

Données d'événements

Le gestionnaire d'événements reçoit un argument de type ObjectReadyEventArgs contenant les données associées à cet événement. Les propriétés suivantes ObjectReadyEventArgs fournissent des informations spécifiques à cet événement.

Property	Description
Context (hérité de ManagementEventArgs)	Obtient le contexte d'opération en écho de l'opération qui a déclenché l'événement.
NewObject	Obtient le nouvel objet retourné.

Sécurité du .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d’informations, consultez Utilisation de bibliothèques à partir de code partiellement approuvé.