AddInProcess Třída

Definice

Obor názvů:

System.AddIn.Hosting

Sestavení:

System.AddIn.dll

Poskytuje externí proces pro spouštění doplňků mimo proces z hostitelské aplikace.

public ref class AddInProcess sealed

public sealed class AddInProcess

type AddInProcess = class

Public NotInheritable Class AddInProcess

Dědičnost

Object

AddInProcess

Příklady

Následující příklad aktivuje doplněk v externím procesu.

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

Poznámky

Chcete-li aktivovat doplněk v externím procesu, předejte AddInProcess objekt do přetížení příslušné AddInToken.Activate<T>(AddInProcess, PermissionSet) metody.

Spustitelný soubor, který spouští doplněk, se získá z jednoho ze dvou souborů nainstalovaných s .NET Framework v adresáři Windows. Ve výchozím nastavení se používá spustitelný soubor, který odpovídá bitům na slovo hostitelské aplikace. Pokud je hostitelem 64bitový proces, AddInProcess.exe se spustí; v opačném případě se AddInProcess32.exe spustí. Chcete-li určit způsob výběru spustitelného souboru, použijte AddInProcess(Platform) konstruktor k vytvoření objektu AddInProcess .

Konstruktory

Name	Description
AddInProcess()	Inicializuje novou instanci AddInProcess třídy.
AddInProcess(Platform)	Inicializuje novou instanci AddInProcess třídy a určuje bity na slovo procesu, ve kterém se doplněk spouští.

Vlastnosti

Name	Description
IsCurrentProcess	Získá hodnotu, která určuje, zda aktuální AddInProcess objekt představuje hostitelský aplikační proces.
KeepAlive	Získá nebo nastaví hodnotu, která označuje, zda chcete zachovat externí proces naživu.
Platform	Získá bity na slovo procesu, ve kterém je spuštěný doplněk mimo proces.
ProcessId	Získá ID procesu externího procesu.
StartupTimeout	Získá nebo nastaví počet sekund, které umožní spuštění procesu.

Metody

Name	Description
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Shutdown()	Vynuceně vypne externí proces.
Start()	Spustí externí proces.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

Name	Description
ShuttingDown	Nastane, když proces reprezentovaný AddInProcess objektem se chystá vypnout.