Compartilhar via


AddInController Classe

Definição

Fornece acesso a um suplemento para uma variedade de tarefas.

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 ativado anteriormente usando 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))

Comentários

Use essa classe para executar as seguintes tarefas:

  • Use a AddInEnvironment propriedade para obter um AddInEnvironment objeto para um suplemento. Em seguida, use esse objeto para ativar outros suplementos no mesmo domínio do aplicativo e processar como o suplemento original.

  • Use a AppDomain propriedade para obter um AppDomain objeto para um suplemento. Em seguida, use esse objeto para ativar outros suplementos no mesmo domínio do aplicativo que o suplemento original. 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.

  • Use a Token propriedade para obter um AddInToken objeto que representa um suplemento.

  • Desligue um suplemento com o Shutdown método .

Para obter o controlador de um suplemento, chame o GetAddInController método e passe uma instância do suplemento como seu parâmetro.

Propriedades

AddInEnvironment

Obtém um objeto AddInEnvironment.

AppDomain

Obtém o domínio do aplicativo que contém um suplemento.

Token

Obtém o token que representa o suplemento.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetAddInController(Object)

Obtém o controlador para um suplemento.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
Shutdown()

Desabilita um suplemento.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a