AddInProcess Třída

Definice

Poskytuje externí proces pro spuštění doplňků z hostitelské aplikace mimo proces.Provides an external process for running add-ins out-of-process from the host application.

public ref class AddInProcess sealed
public sealed class AddInProcess
type AddInProcess = class
Public NotInheritable Class AddInProcess
Dědičnost
AddInProcess

Příklady

Následující příklad aktivuje doplněk v externím procesu.The following example activates an add-in in an external process.

// 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 příslušnému AddInToken.Activate<T>(AddInProcess, PermissionSet) přetížení metody.To activate an add-in in an external process, pass an AddInProcess object to the appropriate AddInToken.Activate<T>(AddInProcess, PermissionSet) method overload.

Spustitelný soubor, který spouští doplněk, se získá z jednoho ze dvou souborů nainstalovaných s .NET Framework pod adresářem Windows.The executable that runs the add-in is obtained from one of two files installed with the .NET Framework under the Windows directory. Ve výchozím nastavení se používá spustitelný soubor, který odpovídá počtu bitů na slovo v hostitelské aplikaci.By default, the executable that matches the bits-per-word of the host application is used. Pokud je hostitelem 64 proces, AddInProcess.exe spustit; v opačném případě AddInProcess32.exe spustit.If the host is a 64-bit process, AddInProcess.exe is run; otherwise, AddInProcess32.exe is run. Chcete-li určit způsob, jakým je vybrán spustitelný soubor, použijte AddInProcess(Platform) konstruktor k vytvoření AddInProcess objektu.To specify the way the executable is selected, use the AddInProcess(Platform) constructor to create the AddInProcess object.

Konstruktory

AddInProcess()

Inicializuje novou instanci AddInProcess třídy.Initializes a new instance of the AddInProcess class.

AddInProcess(Platform)

Inicializuje novou instanci AddInProcess třídy a určí počet bitů na slovo procesu, ve kterém se doplněk spouští.Initializes a new instance of the AddInProcess class, specifying the bits-per-word of the process in which the add-in runs.

Vlastnosti

IsCurrentProcess

Získá hodnotu, která označuje, zda aktuální AddInProcess objekt představuje proces hostitelské aplikace.Gets a value that indicates whether the current AddInProcess object represents the host application process.

KeepAlive

Získává nebo nastavuje hodnotu, která indikuje, jestli se má zachovat aktivní externí proces.Gets or sets a value that indicates whether to keep the external process alive.

Platform

Získá bity na slovo procesu, ve kterém je spuštěn doplněk mimo proces.Gets the bits-per-word of the process in which the out-of-process add-in is run.

ProcessId

Získá ID procesu externího procesu.Gets the process ID of the external process.

StartupTimeout

Získá nebo nastaví počet sekund, po které má být proces spuštěn.Gets or sets the number of seconds to allow for the process to start.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
Shutdown()

Vynuceně vypne externí proces.Forcibly shuts down the external process.

Start()

Spustí externí proces.Starts the external process.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Události

ShuttingDown

Nastane, pokud AddInProcess se chystá vypnutí procesu reprezentovaného objektem.Occurs when the process represented by the AddInProcess object is about to be shut down.

Platí pro

Viz také