AddInController Klasse

Definition

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Bietet Zugriff auf ein Add-In für eine Vielzahl von Aufgaben.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Vererbung

Object

AddInController

Beispiele

Im folgenden Beispiel wird ein Add-In innerhalb derselben Umgebung wie ein zuvor aktiviertes Add-In mithilfe eines AddInController Objekts aktiviert.

// 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))

Hinweise

Verwenden Sie diese Klasse, um die folgenden Aufgaben auszuführen:

• Verwenden Sie die AddInEnvironment Eigenschaft, um ein AddInEnvironment Objekt für ein Add-In abzurufen. Verwenden Sie dann dieses Objekt, um andere Add-Ins in derselben Anwendungsdomäne und demselben Prozess wie das ursprüngliche Add-In zu aktivieren.

• Verwenden Sie die AppDomain Eigenschaft, um ein AppDomain Objekt für ein Add-In abzurufen. Verwenden Sie dann dieses Objekt, um andere Add-Ins in derselben Anwendungsdomäne wie das ursprüngliche Add-In zu aktivieren. Beachten Sie, dass dieses Szenario aufgrund von Einschränkungen beim prozessübergreifenden Remoting nicht mit Add-Ins funktioniert, die in einem separaten Prozess aktiviert werden.

• Verwenden Sie die Token Eigenschaft, um ein AddInToken Objekt abzurufen, das ein Add-In darstellt.

• Herunterfahren eines Add-Ins mit der Shutdown Methode.

Um den Controller für ein Add-In abzurufen, rufen Sie die GetAddInController Methode auf, und übergeben Sie eine Instanz des Add-Ins als Parameter.

Eigenschaften

Name	Beschreibung
AddInEnvironment	Ruft ein AddInEnvironment Objekt ab.
AppDomain	Ruft die Anwendungsdomäne ab, die ein Add-In enthält.
Token	Ruft das Token ab, das das Add-In darstellt.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetAddInController(Object)	Ruft den Controller für ein Add-In ab.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
Shutdown()	Deaktiviert ein Add-In.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)