InstrumentationManager Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
-
InstrumentationManager
Exemples
L’exemple suivant montre comment utiliser le modèle de publication/révocation. Deux instances de la classe router sont créées et publiées. Elles sont ultérieurement révoquées.
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 d’inscription de rappel 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 des instances de classes WMI disponibles : 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 le comportement par défaut de la plupart des 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. Il appelle l’application pour cette fonctionnalité et échoue si elle n’existe pas ou 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 exposer les classes WMI 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. |