AddInProcess Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
-
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) .
Il file eseguibile che esegue il componente aggiuntivo viene ottenuto da uno dei due file installati con .NET Framework nella directory di Windows. Per impostazione predefinita, viene usato l'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 il modo in cui è selezionato il file eseguibile, usare il AddInProcess(Platform) costruttore per creare l'oggetto AddInProcess .
Costruttori
AddInProcess() |
Inizializza una nuova istanza della classe AddInProcess. |
AddInProcess(Platform) |
Inizializza una nuova istanza della classe AddInProcess, specificando i bit per parola del processo in cui viene eseguito il componente aggiuntivo. |
Proprietà
IsCurrentProcess |
Ottiene un valore che indica se l'oggetto AddInProcess corrente 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 consentito prima dell'avvio del processo. |
Metodi
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 l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
Shutdown() |
Impone la chiusura del processo esterno. |
Start() |
Avvia il processo esterno. |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Eventi
ShuttingDown |
Si verifica quando il processo rappresentato dall'oggetto AddInProcess sta per essere chiuso. |