AddInController Clase

Definición

Espacio de nombres:

System.AddIn.Hosting

Ensamblado:

System.AddIn.dll

Proporciona acceso a un complemento para varias tareas.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Herencia

Object

AddInController

Ejemplos

En el ejemplo siguiente se activa un complemento dentro del mismo entorno que un complemento activado previamente mediante un AddInController objeto .

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

Comentarios

Use esta clase para realizar las tareas siguientes:

• Utilice la AddInEnvironment propiedad para obtener un AddInEnvironment objeto para un complemento. Después, use ese objeto para activar otros complementos en el mismo dominio de aplicación y proceso que el complemento original.

• Utilice la AppDomain propiedad para obtener un AppDomain objeto para un complemento. A continuación, use ese objeto para activar otros complementos en el mismo dominio de aplicación que el complemento original. Tenga en cuenta que debido a las limitaciones de la comunicación remota entre procesos, este escenario no funcionará con complementos que se activan en un proceso independiente.

• Utilice la Token propiedad para obtener un AddInToken objeto que representa un complemento.

• Cierre un complemento con el Shutdown método .

Para obtener el controlador de un complemento, llame al GetAddInController método y pase una instancia del complemento como parámetro.

Propiedades

AddInEnvironment	Obtiene un objeto AddInEnvironment.
AppDomain	Obtiene el dominio de aplicación que contiene un complemento.
Token	Obtiene el token que representa el complemento.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetAddInController(Object)	Obtiene el controlador de un complemento.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Shutdown()	Deshabilita un complemento.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)