AddInToken.Activate Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ativa um suplemento.
Sobrecargas
| Activate<T>(AddInEnvironment) |
Ativa um suplemento no ambiente de outro suplemento. |
| Activate<T>(AddInSecurityLevel) |
Ativa um suplemento com um nível de confiança especificado em um novo domínio do aplicativo. |
| Activate<T>(AppDomain) |
Ativa um suplemento em um domínio do aplicativo existente. |
| Activate<T>(PermissionSet) |
Ativa um suplemento com um conjunto de permissões em um novo domínio do aplicativo. |
| Activate<T>(AddInProcess, AddInSecurityLevel) |
Ativa um suplemento em um processo externo, em um novo domínio do aplicativo e com um nível de confiança especificado. |
| Activate<T>(AddInProcess, PermissionSet) |
Ativa um suplemento em um processo externo, em um novo domínio do aplicativo e com um conjunto de permissões especificado. |
| Activate<T>(AddInSecurityLevel, String) |
Ativa um suplemento em um novo domínio do aplicativo com um nível de confiança e um nome especificados. |
Activate<T>(AddInEnvironment)
Ativa um suplemento no ambiente de outro suplemento.
public:
generic <typename T>
T Activate(System::AddIn::Hosting::AddInEnvironment ^ environment);public T Activate<T> (System.AddIn.Hosting.AddInEnvironment environment);member this.Activate : System.AddIn.Hosting.AddInEnvironment -> 'TPublic Function Activate(Of T) (environment As AddInEnvironment) As TParâmetros de tipo
- T
A interface ou o tipo base abstrato que representa a exibição de host do suplemento.
Parâmetros
- environment
- AddInEnvironment
O domínio do aplicativo e o processo que contém o suplemento original.
Retornos
A exibição do suplemento do host.
Exemplos
O exemplo a seguir ativa um suplemento em um domínio de aplicativo gerado automaticamente com um nível de segurança especificado. Em seguida, ele ativa um segundo suplemento no mesmo domínio do aplicativo e processa o primeiro usando o objeto do AddInEnvironment primeiro suplemento.
// 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
Essa sobrecarga de método ativa o suplemento no mesmo domínio do aplicativo e processa o suplemento do qual environment foi obtido.
Confira também
Aplica-se a
Activate<T>(AddInSecurityLevel)
Ativa um suplemento com um nível de confiança especificado em um novo domínio do aplicativo.
public:
generic <typename T>
T Activate(System::AddIn::Hosting::AddInSecurityLevel trustLevel);public T Activate<T> (System.AddIn.Hosting.AddInSecurityLevel trustLevel);member this.Activate : System.AddIn.Hosting.AddInSecurityLevel -> 'TPublic Function Activate(Of T) (trustLevel As AddInSecurityLevel) As TParâmetros de tipo
- T
A interface ou o tipo base abstrato que representa a exibição de host do suplemento.
Parâmetros
- trustLevel
- AddInSecurityLevel
Um dos valores de enumeração que especifica o nível de confiança.
Retornos
A exibição do suplemento do host.
Exemplos
O exemplo a seguir mostra como ativar um suplemento, identificado pelo token escolhido, em um domínio de aplicativo gerado automaticamente com um nível de segurança especificado.
//Ask the user which add-in they would like to use.
AddInToken selectedToken = ChooseAddIn(tokens);
//Activate the selected AddInToken in a new
//application domain with the Internet trust level.
Calculator CalcAddIn = selectedToken.Activate<Calculator>(AddInSecurityLevel.Internet);
//Run the add-in using a custom method.
RunCalculator(CalcAddIn);
'Ask the user which add-in they would like to use.
Dim selectedToken As AddInToken = ChooseAddIn(tokens)
'Activate the selected AddInToken in a new
'application domain with the Internet trust level.
Dim CalcAddIn As Calculator = selectedToken.Activate(Of Calculator)(AddInSecurityLevel.Internet)
'Run the add-in using a custom method.
RunCalculator(CalcAddIn)
Comentários
Essa sobrecarga de método carrega o suplemento em um domínio de aplicativo gerado automaticamente. Se você quiser especificar um nome para o novo domínio do aplicativo, use a Activate<T>(AddInSecurityLevel, String) sobrecarga.
Esse método define o diretório base para o domínio do aplicativo como o local do assembly de suplemento. Ele também procura o arquivo de configuração [addinassemblyname].dll.config e, se encontrado, o define como o arquivo de configuração do novo domínio do aplicativo.
Confira também
Aplica-se a
Activate<T>(AppDomain)
Ativa um suplemento em um domínio do aplicativo existente.
public:
generic <typename T>
T Activate(AppDomain ^ target);public T Activate<T> (AppDomain target);member this.Activate : AppDomain -> 'TPublic Function Activate(Of T) (target As AppDomain) As TParâmetros de tipo
- T
A interface ou o tipo base abstrato que representa a exibição de host do suplemento.
Parâmetros
- target
- AppDomain
O domínio do aplicativo em que o suplemento deve ser ativado.
Retornos
A exibição do suplemento do host.
Exceções
A permissão de confiança total é exigida. Um chamador na cadeia de chamadas não tem permissão suficiente.
Exemplos
O exemplo a seguir ativa um suplemento em um domínio de aplicativo que está sendo usado por outro suplemento. O código do primeiro suplemento é fornecido na AddInToken classe .
// Get the application domain
// of an existing add-in (CalcAddIn).
AddInController aiCtrl = AddInController.GetAddInController(CalcAddIn);
AppDomain AddInAppDom = aiCtrl.AppDomain;
// Activate another add-in in the same application domain.
Calculator CalcAddIn3 =
selectedToken2.Activate<Calculator>(AddInAppDom);
// Show that CalcAddIn3 was loaded
// into CalcAddIn's application domain.
AddInController aic = AddInController.GetAddInController(CalcAddIn3);
Console.WriteLine("Add-in loaded into existing application domain: {0}",
aic.AppDomain.Equals(AddInAppDom));
' Get the application domain
' of an existing add-in (CalcAddIn).
Dim aiCtrl As AddInController = AddInController.GetAddInController(CalcAddIn)
Dim AddInAppDom As AppDomain = aiCtrl.AppDomain
' Activate another add-in in the same appliation domain.
Dim CalcAddIn3 As Calculator = selectedToken2.Activate(Of Calculator)(AddInAppDom)
' Show that the CalcAddIn3 was loaded
' into CalcCaddIn's application domain.
Dim aic As AddInController = AddInController.GetAddInController(CalcAddIn3)
Console.WriteLine("Add-in loaded into existing application domain: {0}", _
aic.AppDomain.Equals(AddInAppDom))
Comentários
Para ativar um suplemento em um domínio de aplicativo gerado automaticamente, use a Activate<T>(AddInSecurityLevel) sobrecarga para gerar um novo domínio de aplicativo com um nível de segurança especificado ou a Activate<T>(AddInSecurityLevel, String) sobrecarga para incluir um nome amigável para o domínio do aplicativo.
Aplica-se a
Activate<T>(PermissionSet)
Ativa um suplemento com um conjunto de permissões em um novo domínio do aplicativo.
public:
generic <typename T>
T Activate(System::Security::PermissionSet ^ permissions);public T Activate<T> (System.Security.PermissionSet permissions);member this.Activate : System.Security.PermissionSet -> 'TPublic Function Activate(Of T) (permissions As PermissionSet) As TParâmetros de tipo
- T
A interface ou o tipo base abstrato que representa a exibição de host do suplemento.
Parâmetros
- permissions
- PermissionSet
As permissões concedidas para o suplemento.
Retornos
A exibição do suplemento do host.
Exceções
permissions é null.
Comentários
Essa sobrecarga de método carrega o suplemento em um domínio de aplicativo gerado automaticamente. Ele define o diretório base para o domínio do aplicativo como o local do assembly de suplemento. Ele também procura o arquivo [addinassemblyname].dll.config de configuração e, se encontrado, define-o como o arquivo de configuração para o novo domínio do aplicativo.
Aplica-se a
Activate<T>(AddInProcess, AddInSecurityLevel)
Ativa um suplemento em um processo externo, em um novo domínio do aplicativo e com um nível de confiança especificado.
public:
generic <typename T>
T Activate(System::AddIn::Hosting::AddInProcess ^ process, System::AddIn::Hosting::AddInSecurityLevel level);public T Activate<T> (System.AddIn.Hosting.AddInProcess process, System.AddIn.Hosting.AddInSecurityLevel level);member this.Activate : System.AddIn.Hosting.AddInProcess * System.AddIn.Hosting.AddInSecurityLevel -> 'TPublic Function Activate(Of T) (process As AddInProcess, level As AddInSecurityLevel) As TParâmetros de tipo
- T
A interface ou o tipo base abstrato que representa a exibição de host do suplemento.
Parâmetros
- process
- AddInProcess
O processo externo no qual ativar o suplemento.
- level
- AddInSecurityLevel
Um dos valores de enumeração que especifica o nível de confiança.
Retornos
A exibição do suplemento do host.
Exemplos
O exemplo a seguir cria um novo processo e ativa um suplemento nesse processo com um nível de segurança de confiança total.
// Create an external process.
AddInProcess pExternal = new AddInProcess();
// Activate an add-in in the external process
// with a full trust security level.
Calculator CalcAddIn4 =
selectedToken.Activate<Calculator>(pExternal,
AddInSecurityLevel.FullTrust);
// Show that the add-in is an external process
// by verifying that it is not in the current (host's) process.
AddInController AddinCtl = AddInController.GetAddInController(CalcAddIn4);
Console.WriteLine("Add-in in host's process: {0}",
AddinCtl.AddInEnvironment.Process.IsCurrentProcess);
' Create an external process.
Dim pExternal As New AddInProcess()
' Activate an add-in in the external process
' with a full trust security level.
Dim CalcAddIn4 As Calculator = _
selectedToken.Activate(Of Calculator)(pExternal, _
AddInSecurityLevel.FullTrust)
' Show that the add-in is an external process
' by verifying that it is not in the current (host's) process.
Dim AddinCtl As AddInController = AddInController.GetAddInController(CalcAddIn4)
Console.WriteLine("Add-in in host's process: {0}", _
AddinCtl.AddInEnvironment.Process.IsCurrentProcess)
Comentários
Esse método define o diretório base para o domínio do aplicativo como o local do assembly de suplemento. Ele também procura o arquivo [addinassemblyname].dll.config de configuração e, se encontrado, define-o como o arquivo de configuração para o novo domínio do aplicativo.
Aplica-se a
Activate<T>(AddInProcess, PermissionSet)
Ativa um suplemento em um processo externo, em um novo domínio do aplicativo e com um conjunto de permissões especificado.
public:
generic <typename T>
T Activate(System::AddIn::Hosting::AddInProcess ^ process, System::Security::PermissionSet ^ permissionSet);public T Activate<T> (System.AddIn.Hosting.AddInProcess process, System.Security.PermissionSet permissionSet);member this.Activate : System.AddIn.Hosting.AddInProcess * System.Security.PermissionSet -> 'TPublic Function Activate(Of T) (process As AddInProcess, permissionSet As PermissionSet) As TParâmetros de tipo
- T
A interface ou o tipo base abstrato que representa a exibição de host do suplemento.
Parâmetros
- process
- AddInProcess
O processo externo no qual ativar o suplemento.
- permissionSet
- PermissionSet
O conjunto de permissões necessárias concedido para o suplemento.
Retornos
A exibição do suplemento do host.
Comentários
Esse método define o diretório base para o domínio do aplicativo como o local do assembly de suplemento. Ele também procura o arquivo [addinassemblyname].dll.config de configuração e, se encontrado, define-o como o arquivo de configuração para o novo domínio do aplicativo.
Aplica-se a
Activate<T>(AddInSecurityLevel, String)
Ativa um suplemento em um novo domínio do aplicativo com um nível de confiança e um nome especificados.
public:
generic <typename T>
T Activate(System::AddIn::Hosting::AddInSecurityLevel trustLevel, System::String ^ appDomainName);public T Activate<T> (System.AddIn.Hosting.AddInSecurityLevel trustLevel, string appDomainName);member this.Activate : System.AddIn.Hosting.AddInSecurityLevel * string -> 'TPublic Function Activate(Of T) (trustLevel As AddInSecurityLevel, appDomainName As String) As TParâmetros de tipo
- T
A interface ou o tipo base abstrato que representa a exibição de host do suplemento.
Parâmetros
- trustLevel
- AddInSecurityLevel
Um dos valores de enumeração que especifica o nível de confiança.
- appDomainName
- String
O nome amigável para atribuir ao novo domínio do aplicativo.
Retornos
A exibição do suplemento do host.
Comentários
Se você não precisar especificar um nome de domínio do aplicativo, use a Activate<T>(AddInSecurityLevel) sobrecarga.
Esse método define o diretório base para o domínio do aplicativo como o local do assembly de suplemento. Ele também procura o arquivo [addinassemblyname].dll.config de configuração e, se encontrado, define-o como o arquivo de configuração para o novo domínio do aplicativo.
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de