AddInController Classe

Definição

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Herança

Object

AddInController

Exemplos

O exemplo seguinte ativa um add-in no mesmo ambiente de um add-in previamente ativado ao usar um 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))

Observações

Use esta classe para realizar as seguintes tarefas:

• Use a AddInEnvironment propriedade para obter um AddInEnvironment objeto para um complemento. Depois, usa esse objeto para ativar outros complementos no mesmo domínio de aplicação e processo do complemento original.

• Use a AppDomain propriedade para obter um AppDomain objeto para um complemento. Depois, usa esse objeto para ativar outros complementos no mesmo domínio de aplicação do complemento original. Note-se que, devido a limitações no remoto entre processos, este cenário não funcionará com complementos ativados num processo separado.

• Use a Token propriedade para obter um AddInToken objeto que represente um complemento.

• Encerra um complemento com o Shutdown método.

Para obter o controlador para um complemento, chama o GetAddInController método e passa uma instância do add-in como seu parâmetro.