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ń:

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

• AppDomain Użyj właściwości , 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 dodatkiami aktywowanymi w osobnym procesie.

• Token Użyj właściwości , 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

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

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetAddInController(Object)	Uzyskuje kontroler dodatku.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Shutdown()	Wyłącza dodatek.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)