AddInController Třída

Definice

Obor názvů:

System.AddIn.Hosting

Sestavení:

System.AddIn.dll

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

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:

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

• AppDomain Vlastnost slouží k získání objektu AppDomain pro doplněk. 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 kvůli omezením komunikace mezi procesy tento scénář nebude fungovat s doplňky aktivovanými v samostatném procesu.

• Token Vlastnost slouží k získání objektuAddInToken, který představuje doplněk.

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

Chcete-li získat kontroler pro doplněk, zavolejte metodu GetAddInController a předejte instanci doplňku jako jeho parametr.

Vlastnosti

Name	Description
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

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetAddInController(Object)	Získá kontroler pro doplněk.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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)