AddInController Třída

Definice

Obor názvů:

System.AddIn.Hosting

Sestavení:

System.AddIn.dll

Poskytuje přístup k doplňku pro různé úkoly.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Dědičnost

Object

AddInController

Příklady

Následující příklad aktivuje doplněk ve stejném prostředí jako dříve aktivovaný doplněk pomocí objektu AddInController .

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

Poznámky

Pomocí této třídy můžete provádět následující úlohy:

• K získání objektu AddInEnvironmentAddInEnvironment pro doplněk použijte vlastnost . Potom tento objekt použijte k aktivaci dalších doplňků ve stejné doméně aplikace a procesu jako původní doplněk.

• K získání objektu AppDomainAppDomain pro doplněk použijte vlastnost . Potom tento objekt použijte k aktivaci dalších doplňků ve stejné doméně aplikace jako původní doplněk. Mějte na paměti, že z důvodu omezení při vzdálené komunikace mezi procesy nebude tento scénář fungovat s doplňky, které jsou aktivovány v samostatném procesu.

• Token Pomocí vlastnosti získejte AddInToken objekt, který představuje doplněk.

• Vypněte doplněk pomocí Shutdown metody .

Chcete-li získat kontroler doplňku, zavolejte metodu GetAddInController a předejte instanci doplňku jako její parametr.

Vlastnosti

AddInEnvironment	AddInEnvironment Získá objekt.
AppDomain	Získá doménu aplikace, která obsahuje doplněk.
Token	Získá token, který představuje doplněk.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetAddInController(Object)	Získá kontroler pro doplněk.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Shutdown()	Zakáže doplněk.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)