AddInController Classe
Definição
Fornece acesso a um suplemento para uma variedade de tarefas.Provides access to an add-in for a variety of tasks.
public ref class AddInController sealed
public sealed class AddInController
type AddInController = class
Public NotInheritable Class AddInController
- Herança
-
AddInController
Exemplos
O exemplo a seguir ativa um suplemento dentro do mesmo ambiente que um suplemento previamente ativado usando um AddInController objeto.The following example activates an add-in within the same environment as a previously activated add-in by using an AddInController object.
// 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))
Comentários
Use esta classe para executar as seguintes tarefas:Use this class to perform the following tasks:
Use a AddInEnvironment propriedade para obter um AddInEnvironment objeto para um suplemento.Use the AddInEnvironment property to obtain an AddInEnvironment object for an add-in. Em seguida, use esse objeto para ativar outros suplementos no mesmo domínio de aplicativo e processo que o suplemento original.Then use that object to activate other add-ins in the same application domain and process as the original add-in.
Use a AppDomain propriedade para obter um AppDomain objeto para um suplemento.Use the AppDomain property to obtain an AppDomain object for an add-in. Em seguida, use esse objeto para ativar outros suplementos no mesmo domínio de aplicativo que o suplemento original.Then use that object to activate other add-ins in the same application domain as the original add-in. Observe que, devido a limitações na comunicação remota entre processos, esse cenário não funcionará com suplementos que são ativados em um processo separado.Note that because of limitations in cross-process remoting, this scenario will not work with add-ins that are activated in a separate process.
Use a Token propriedade para obter um AddInToken objeto que representa um suplemento.Use the Token property to obtain an AddInToken object that represents an add-in.
Desligue um suplemento com o Shutdown método.Shut down an add-in with the Shutdown method.
Para obter o controlador para um suplemento, chame o GetAddInController método e passe uma instância do suplemento como seu parâmetro.To obtain the controller for an add-in, call the GetAddInController method and pass an instance of the add-in as its parameter.
Propriedades
| AddInEnvironment |
Obtém um objeto AddInEnvironment.Gets an AddInEnvironment object. |
| AppDomain |
Obtém o domínio do aplicativo que contém um suplemento.Gets the application domain that contains an add-in. |
| Token |
Obtém o token que representa o suplemento.Gets the token that represents the add-in. |
Métodos
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| GetAddInController(Object) |
Obtém o controlador para um suplemento.Obtains the controller for an add-in. |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| Shutdown() |
Desabilita um suplemento.Disables an add-in. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Object) |