AddInProcess Klasse

Definition

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Stellt einen externen Prozess zum prozessexternen Ausführen von Add-Ins über die Hostanwendung bereit.

public ref class AddInProcess sealed

public sealed class AddInProcess

type AddInProcess = class

Public NotInheritable Class AddInProcess

Vererbung

Object

AddInProcess

Beispiele

Im folgenden Beispiel wird ein Add-In in einem externen Prozess aktiviert.

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

Hinweise

Um ein Add-In in einem externen Prozess zu aktivieren, übergeben Sie ein AddInProcess Objekt an die entsprechende AddInToken.Activate<T>(AddInProcess, PermissionSet) Methodenüberladung.

Die ausführbare Datei, die das Add-In ausführt, wird aus einer von zwei Dateien abgerufen, die mit dem .NET Framework im Windows-Verzeichnis installiert sind. Standardmäßig wird die ausführbare Datei verwendet, die mit den Bits pro Wort der Hostanwendung übereinstimmt. Wenn der Host ein 64-Bit-Prozess ist, wird AddInProcess.exe ausgeführt. andernfalls wird AddInProcess32.exe ausgeführt. Um anzugeben, wie die ausführbare Datei ausgewählt wird, verwenden Sie den AddInProcess(Platform) Konstruktor, um das AddInProcess Objekt zu erstellen.

Konstruktoren

AddInProcess()	Initialisiert eine neue Instanz der AddInProcess-Klasse.
AddInProcess(Platform)	Initialisiert eine neue Instanz der AddInProcess-Klasse und gibt die Bits pro Wort des Prozesses an, in dem das Add-In ausgeführt wird.

Eigenschaften

IsCurrentProcess	Ruft einen Wert ab, der angibt, ob das aktuelle AddInProcess-Objekt den Hostanwendungsprozess darstellt.
KeepAlive	Ruft einen Wert ab, der angibt, ob der externe Prozess beibehalten werden soll, oder legt diesen Wert fest.
Platform	Ruft die Bits pro Wort des Prozesses ab, in dem das prozessexterne Add-In ausgeführt wird.
ProcessId	Ruft die Prozess-ID des externen Prozesses ab.
StartupTimeout	Ruft die zulässige Anzahl von Sekunden zum Starten des Prozesses ab oder legt diese fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Shutdown()	Erzwingt das Beenden des externen Prozesses.
Start()	Startet den externen Prozess.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

ShuttingDown

Tritt ein, wenn der durch das AddInProcess-Objekt dargestellte Prozess gerade beendet werden soll.

Weitere Informationen

• Add-Ins und Erweiterbarkeit