AddInProcess Classe

  • Referência

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.

Aplica-se a

Confira também