AddInProcess Classe

Definizione

Spazio dei nomi:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Fornisce un processo esterno per l'esecuzione di componenti aggiuntivi out-of-process dall'applicazione host.

public ref class AddInProcess sealed

public sealed class AddInProcess

type AddInProcess = class

Public NotInheritable Class AddInProcess

Ereditarietà

Object

AddInProcess

Esempio

Nell'esempio seguente viene attivato un componente aggiuntivo in un processo esterno.

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

Commenti

Per attivare un componente aggiuntivo in un processo esterno, passare un AddInProcess oggetto all'overload del metodo appropriato AddInToken.Activate<T>(AddInProcess, PermissionSet) .

L'eseguibile che esegue il componente aggiuntivo viene ottenuto da uno dei due file installati con .NET Framework nella directory Windows. Per impostazione predefinita, viene usato il file eseguibile che corrisponde ai bit per parola dell'applicazione host. Se l'host è un processo a 64 bit, AddInProcess.exe viene eseguito; in caso contrario, AddInProcess32.exe viene eseguito. Per specificare la modalità di selezione dell'eseguibile, usare il AddInProcess(Platform) costruttore per creare l'oggetto AddInProcess .

Costruttori

Nome	Descrizione
AddInProcess()	Inizializza una nuova istanza della classe AddInProcess.
AddInProcess(Platform)	Inizializza una nuova istanza della AddInProcess classe , specificando i bit per parola del processo in cui viene eseguito il componente aggiuntivo.

Proprietà

Nome	Descrizione
IsCurrentProcess	Ottiene un valore che indica se l'oggetto corrente AddInProcess rappresenta il processo dell'applicazione host.
KeepAlive	Ottiene o imposta un valore che indica se mantenere attivo il processo esterno.
Platform	Ottiene i bit per parola del processo in cui viene eseguito il componente aggiuntivo out-of-process.
ProcessId	Ottiene l'ID del processo esterno.
StartupTimeout	Ottiene o imposta il numero di secondi per consentire l'avvio del processo.

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
Shutdown()	Arresta forzatamente il processo esterno.
Start()	Avvia il processo esterno.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

Nome	Descrizione
ShuttingDown	Si verifica quando il processo rappresentato dall'oggetto AddInProcess sta per essere arrestato.