AddInController Classe

Définition

Espace de noms:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Fournit l'accès à un complément pour différentes tâches.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Héritage

Object

AddInController

Exemples

L’exemple suivant active un complément dans le même environnement qu’un complément précédemment activé à l’aide d’un AddInController objet .

// Get the AddInController of a
// currently actived add-in (CalcAddIn).
AddInController aiController = AddInController.GetAddInController(CalcAddIn);

// Select another token.
AddInToken selectedToken2 = ChooseAddIn(tokens);

// Activate a second add-in, CalcAddIn2, in the same
// appliation domain and process as the first add-in by passing
// the first add-in's AddInEnvironment object to the Activate method.
AddInEnvironment aiEnvironment = aiController.AddInEnvironment;
Calculator CalcAddIn2 =
    selectedToken2.Activate<Calculator>(aiEnvironment);

// Get the AddInController for the second add-in to compare environments.
AddInController aiController2 = AddInController.GetAddInController(CalcAddIn2);
Console.WriteLine("Add-ins in same application domain: {0}", aiController.AppDomain.Equals(aiController2.AppDomain));
Console.WriteLine("Add-ins in same process: {0}", aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process));

' Get the AddInController of a 
' currently activated add-in (CalcAddIn).
Dim aiController As AddInController = AddInController.GetAddInController(CalcAddIn)

' Select another token.
Dim selectedToken2 As AddInToken = ChooseAddIn(tokens)

' Activate a second add-in, CalcAddIn2, in the same
' appliation domain and process as the first add-in by passing
' the first add-in's AddInEnvironment object to the Activate method.

Dim aiEnvironment As AddInEnvironment = aiController.AddInEnvironment
Dim CalcAddIn2 As Calculator = _
    selectedToken2.Activate(Of Calculator)(aiEnvironment)

' Get the AddInController for the second add-in to compare environments.
Dim aiController2 As AddInController = AddInController.GetAddInController(CalcAddIn2)

Console.WriteLine("Add-ins in same application domain: {0}", _
    aiController.AppDomain.Equals(aiController2.AppDomain))
Console.WriteLine("Add-ins in same process: {0}", _
    aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process))

Remarques

Utilisez cette classe pour effectuer les tâches suivantes :

• Utilisez la AddInEnvironment propriété pour obtenir un AddInEnvironment objet pour un complément. Utilisez ensuite cet objet pour activer d’autres compléments dans le même domaine d’application et le même processus que le complément d’origine.

• Utilisez la AppDomain propriété pour obtenir un AppDomain objet pour un complément. Utilisez ensuite cet objet pour activer d’autres compléments dans le même domaine d’application que le complément d’origine. Notez qu’en raison des limitations de la communication à distance entre processus, ce scénario ne fonctionnera pas avec les compléments qui sont activés dans un processus distinct.

• Utilisez la Token propriété pour obtenir un AddInToken objet qui représente un complément.

• Arrêtez un complément avec la Shutdown méthode .

Pour obtenir le contrôleur d’un complément, appelez la GetAddInController méthode et passez une instance du complément en tant que paramètre.

Propriétés

AddInEnvironment	Obtient un objet AddInEnvironment.
AppDomain	Obtient le domaine d'application qui contient un complément.
Token	Obtient le jeton qui représente le complément.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetAddInController(Object)	Obtient le contrôleur pour un complément.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Shutdown()	Désactive un complément.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)