AddInController Klasa

Definicja

Przestrzeń nazw:

System.AddIn.Hosting

Zestaw:

System.AddIn.dll

Zapewnia dostęp do dodatku dla różnych zadań.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Dziedziczenie

Object

AddInController

Przykłady

Poniższy przykład aktywuje dodatek w tym samym środowisku co wcześniej aktywowany dodatek przy użyciu AddInController obiektu.

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

Uwagi

Ta klasa służy do wykonywania następujących zadań:

• Użyj właściwości , AddInEnvironment aby uzyskać AddInEnvironment obiekt dodatku. Następnie użyj tego obiektu, aby aktywować inne dodatki w tej samej domenie aplikacji i przetwarzać co oryginalny dodatek.

• Użyj właściwości , AppDomain aby uzyskać AppDomain obiekt dodatku. Następnie użyj tego obiektu, aby aktywować inne dodatki w tej samej domenie aplikacji co oryginalny dodatek. Należy pamiętać, że ze względu na ograniczenia dotyczące komunikacji między procesami ten scenariusz nie będzie działać z dodatkami aktywowanymi w osobnym procesie.

• Użyj właściwości , Token aby uzyskać AddInToken obiekt reprezentujący dodatek.

• Zamknij dodatek za pomocą Shutdown metody .

Aby uzyskać kontroler dodatku, wywołaj GetAddInController metodę i przekaż wystąpienie dodatku jako jego parametr.

Właściwości

Nazwa	Opis
AddInEnvironment	AddInEnvironment Pobiera obiekt.
AppDomain	Pobiera domenę aplikacji zawierającą dodatek.
Token	Pobiera token reprezentujący dodatek.

Metody

Nazwa	Opis
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetAddInController(Object)	Uzyskuje kontroler dodatku.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Shutdown()	Wyłącza dodatek.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)