AddInController Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
-
AddInController
Ejemplos
En el ejemplo siguiente se activa un complemento dentro del mismo entorno que un complemento activado anteriormente 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 siguientes tareas:
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 procesar que el complemento original.
Utilice la AppDomain propiedad para obtener un AppDomain objeto para un complemento. Después, 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 en 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 represente un complemento.
Apague 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 su 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) |