AddInProcess Clase

Definición

Espacio de nombres:

System.AddIn.Hosting

Ensamblado:

System.AddIn.dll

Proporciona un proceso externo para ejecutar los 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 ejecutable que ejecuta el complemento se obtiene de uno de los dos archivos instalados con .NET Framework en el directorio de 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 ejecutable, use el AddInProcess(Platform) constructor para crear el AddInProcess objeto.

Constructores

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

Propiedades

IsCurrentProcess	Obtiene un valor que indica si el objeto AddInProcess actual representa el proceso de la aplicación host.
KeepAlive	Obtiene o establece un valor que indica si se va a 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 del proceso externo.
StartupTimeout	Obtiene o establece el número de segundos que se permite para iniciar el proceso.

Métodos

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

Eventos

ShuttingDown

Se produce cuando el proceso representado por el objeto AddInProcess está a punto de cerrarse.

Consulte también

• Complementos y extensibilidad