AddInController Classe

Definizione

Spazio dei nomi:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Consente di accedere a un componente aggiuntivo per eseguire varie attività.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Ereditarietà

Object

AddInController

Esempio

Nell'esempio seguente viene attivato un componente aggiuntivo all'interno dello stesso ambiente di un componente aggiuntivo attivato in precedenza usando un AddInController oggetto .

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

Commenti

Usare questa classe per eseguire le attività seguenti:

• Utilizzare la AddInEnvironment proprietà per ottenere un oggetto per un AddInEnvironment componente aggiuntivo. Usare quindi tale oggetto per attivare altri componenti aggiuntivi nello stesso dominio dell'applicazione e elaborare il componente aggiuntivo originale.

• Utilizzare la AppDomain proprietà per ottenere un oggetto per un AppDomain componente aggiuntivo. Usare quindi tale oggetto per attivare altri componenti aggiuntivi nello stesso dominio dell'applicazione del componente aggiuntivo originale. Si noti che a causa delle limitazioni nella comunicazione remota tra processi, questo scenario non funzionerà con i componenti aggiuntivi attivati in un processo separato.

• Utilizzare la Token proprietà per ottenere un oggetto che rappresenta un AddInToken componente aggiuntivo.

• Arrestare un componente aggiuntivo con il Shutdown metodo .

Per ottenere il controller per un componente aggiuntivo, chiamare il GetAddInController metodo e passare un'istanza del componente aggiuntivo come parametro.

Proprietà

AddInEnvironment	Ottiene un oggetto AddInEnvironment.
AppDomain	Ottiene il dominio applicazione contenente un componente aggiuntivo.
Token	Ottiene il token che rappresenta il componente aggiuntivo.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetAddInController(Object)	Ottiene il controller di un componente aggiuntivo.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Shutdown()	Disabilita un componente aggiuntivo.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)