AddInProcess Classe

Definição

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

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

Object

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.

Confira também

• Suplementos e extensibilidade