Freigeben über

AddInProcess Klasse

Definition

Namespace:
System.AddIn.Hosting
Assembly:
System.AddIn.dll

Stellt einen externen Prozess zum Ausführen von Add-Ins außerhalb des Prozesses aus der 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 verzeichnis Windows 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

Name Beschreibung
AddInProcess()

Initialisiert eine neue Instanz der AddInProcess-Klasse.
AddInProcess(Platform)

Initialisiert eine neue Instanz der AddInProcess Klasse, wobei die Bits pro Wort des Prozesses angegeben werden, in dem das Add-In ausgeführt wird.

Eigenschaften

Name Beschreibung
IsCurrentProcess

Ruft einen Wert ab, der angibt, ob das aktuelle AddInProcess Objekt den Hostanwendungsprozess darstellt.
KeepAlive

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der externe Prozess aktiv bleibt.
Platform

Ruft die Bits pro Wort des Prozesses ab, in dem das Out-of-Process-Add-In ausgeführt wird.
ProcessId

Ruft die Prozess-ID des externen Prozesses ab.
StartupTimeout

Ruft die Anzahl der Sekunden ab, die den Start des Prozesses zulassen sollen, oder legt diese fest.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-Hashfunktion

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
Shutdown()

Der externe Prozess wird forcibly heruntergefahren.
Start()

Startet den externen Prozess.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Ereignisse

Name Beschreibung
ShuttingDown

Tritt auf, wenn der durch das AddInProcess Objekt dargestellte Prozess beendet werden soll.

Gilt für: