InstrumentationManager Classe

Définition

Espace de noms:

System.Management.Instrumentation

Assembly:

System.Management.Instrumentation.dll

Fournit des méthodes qui gèrent la durée de vie et le modèle utilisé pour les fournisseurs découplés.

Remarque : les bibliothèques .NET de WMI sont aujourd’hui considérées comme dans un état final et ne recevront plus de développements, d’améliorations ou de mises à jour en dehors des problèmes de sécurité qui affectent ces bibliothèques. Les API MI doivent être utilisées pour tout nouveau développement.

public ref class InstrumentationManager abstract sealed

public static class InstrumentationManager

type InstrumentationManager = class

Public Class InstrumentationManager

Héritage

Object

InstrumentationManager

Exemples

L’exemple suivant montre comment utiliser le modèle de publication/révocation. Deux instances de la classe de routeur sont créées et publiées. Ils sont révoqués ultérieurement.

public class Sample_InstanceProvider  
{  
    public int Main (string[] args)   
    {  
        var r_one = new Router();
        r_one.Name = "one";  
        InstrumentationManager.Publish(r_one);  
        var r_two = new Router ();  
        r_two.Name = "two";  
        InstrumentationManager.Publish(r_two);  
        // ....  
        InstrumentationManager.Revoke(r_one);  
        InstrumentationManager.Revoke(r_two);  
        return 0;  
    }  
}  

Dans l’exemple suivant, la méthode de rappel d’inscription est utilisée pour exposer la classe RouterNew.

public int MainNew(string[] args)   
{  
    InstrumentationManager.RegisterType(typeof(RouterNew));  
    // ....  
    InstrumentationManager.UnRegisterType(typeof(RouterNew));  
    return 0;  
}  

Remarques

Les fournisseurs découplés sont hébergés par une application. Deux méthodes peuvent être utilisées par l’application pour rendre disponibles des instances de classes WMI : publish/revoke ou la méthode de rappel. La méthode de rappel utilise les RegisterType méthodes et UnregisterType .

Dans le modèle de publication/révocation, l’infrastructure WMI fournit un comportement par défaut pour de nombreuses méthodes que vous devez écrire vous-même dans la méthode de rappel. Il s’agit notamment des méthodes d’énumération et de liaison. Dans ce modèle, l’application crée des instances et les publie. L’application est chargée de s’assurer que les propriétés de clé des classes sont respectées. L’application est également responsable de la suppression des instances.

Dans le modèle de rappel, l’infrastructure WMI s’attend à ce que l’application dispose de méthodes qui gèrent l’énumération, la liaison et toutes les autres méthodes requises pour implémenter les fonctionnalités du fournisseur. Elle appelle l’application pour cette fonctionnalité et échoue si elle n’existe pas ou si elle n’est pas implémentée correctement. L’application inscrit le type de ses classes WMI auprès de l’infrastructure en appelant RegisterType et indique qu’elle ne souhaite plus que les classes WMI soient exposées en appelant UnregisterType.

Méthodes

Publish(Object)	Rend une instance d’un fournisseur disponible dans l’infrastructure WMI.
RegisterAssembly(Assembly)	Enregistre un assembly avec l'infrastructure WMI.
RegisterType(Type)	Enregistre une classe avec l'infrastructure WMI.
Revoke(Object)	Prend une instance d’un fournisseur actuellement disponible et le rend indisponible au sein de l’infrastructure WMI.
UnregisterAssembly(Assembly)	Annule l'enregistrement d'un assembly actuellement enregistré avec l'infrastructure WMI.
UnregisterType(Type)	Annule l'enregistrement d'une classe enregistrée avec l'infrastructure WMI.