Compartilhar via


AddInProcess Classe

Definição

Fornece um processo externo para executar suplementos fora do processo por meio do aplicativo host.

public ref class AddInProcess sealed
public sealed class AddInProcess
type AddInProcess = class
Public NotInheritable Class AddInProcess
Herança
AddInProcess

Exemplos

O exemplo a seguir ativa um suplemento em um processo externo.

// 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

Para ativar um suplemento em um processo externo, passe um AddInProcess objeto para a sobrecarga de método apropriada AddInToken.Activate<T>(AddInProcess, PermissionSet) .

O executável que executa o suplemento é obtido de um dos dois arquivos instalados com o .NET Framework no diretório do Windows. Por padrão, o executável que corresponde aos bits por palavra do aplicativo host é usado. Se o host for um processo de 64 bits, AddInProcess.exe será executado; caso contrário, AddInProcess32.exe é executado. Para especificar a maneira como o executável é selecionado, use o AddInProcess(Platform) construtor para criar o AddInProcess objeto.

Construtores

AddInProcess()

Inicializa uma nova instância da classe AddInProcess.

AddInProcess(Platform)

Inicializa uma nova instância da classe AddInProcess, especificando os bits por palavra do processo em que o suplemento é executado.

Propriedades

IsCurrentProcess

Obtém um valor que indica se o objeto AddInProcess atual representa o processo do aplicativo host.

KeepAlive

Obtém ou define um valor que indica se deve manter o processo externo ativo.

Platform

Obtém os bits por palavra do processo no qual o suplemento fora do processo é executado.

ProcessId

Obtém a ID de processo do processo externo.

StartupTimeout

Obtém ou define o número de segundos para permitir que o processo seja iniciado.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
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()

Desliga o processo externo de modo forçado.

Start()

Inicia o processo externo.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

ShuttingDown

Ocorre quando o processo representado pelo objeto AddInProcess está prestes a ser desligado.

Aplica-se a

Confira também