AddInController Klasse

Definition

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Stellt den Zugriff auf ein Add-In für eine Reihe von Aufgaben bereit.

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 in 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 dieses Objekt dann, 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 dieses Objekt dann, 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.

• Fahren Sie ein Add-In mit der Shutdown -Methode herunter.

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

Eigenschaften

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

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