AddInProcess Clase

Definición

Espacio de nombres:

System.AddIn.Hosting

Ensamblado:

System.AddIn.dll

Proporciona un proceso externo para ejecutar complementos fuera de proceso desde la aplicación host.

public ref class AddInProcess sealed

public sealed class AddInProcess

type AddInProcess = class

Public NotInheritable Class AddInProcess

Herencia

Object

AddInProcess

Ejemplos

En el ejemplo siguiente se activa un complemento en un proceso 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)

Comentarios

Para activar un complemento en un proceso externo, pase un AddInProcess objeto a la sobrecarga de método adecuada AddInToken.Activate<T>(AddInProcess, PermissionSet) .

El archivo ejecutable que ejecuta el complemento se obtiene de uno de los dos archivos instalados con .NET Framework en el directorio Windows. De forma predeterminada, se usa el archivo ejecutable que coincide con los bits por palabra de la aplicación host. Si el host es un proceso de 64 bits, se ejecuta AddInProcess.exe; de lo contrario, se ejecuta AddInProcess32.exe. Para especificar la forma en que se selecciona el archivo ejecutable, use el AddInProcess(Platform) constructor para crear el AddInProcess objeto .

Constructores

Nombre	Description
AddInProcess()	Inicializa una nueva instancia de la clase AddInProcess.
AddInProcess(Platform)	Inicializa una nueva instancia de la AddInProcess clase , especificando los bits por palabra del proceso en el que se ejecuta el complemento.

Propiedades

Nombre	Description
IsCurrentProcess	Obtiene un valor que indica si el objeto actual AddInProcess representa el proceso de aplicación host.
KeepAlive	Obtiene o establece un valor que indica si se debe mantener activo el proceso externo.
Platform	Obtiene los bits por palabra del proceso en el que se ejecuta el complemento fuera de proceso.
ProcessId	Obtiene el identificador de proceso del proceso externo.
StartupTimeout	Obtiene o establece el número de segundos que se va a permitir que se inicie el proceso.

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Shutdown()	Cierra forzadamente el proceso externo.
Start()	Inicia el proceso externo.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

Nombre	Description
ShuttingDown	Se produce cuando el proceso representado por el AddInProcess objeto está a punto de apagarse.