AddInProcess Klasa

Definicja

Przestrzeń nazw:

System.AddIn.Hosting

Zestaw:

System.AddIn.dll

Udostępnia zewnętrzny proces uruchamiania dodatków poza procesem z aplikacji hosta.

public ref class AddInProcess sealed

public sealed class AddInProcess

type AddInProcess = class

Public NotInheritable Class AddInProcess

Dziedziczenie

Object

AddInProcess

Przykłady

Poniższy przykład aktywuje dodatek w procesie zewnętrznym.

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

Uwagi

Aby aktywować dodatek w procesie zewnętrznym, przekaż AddInProcess obiekt do odpowiedniego AddInToken.Activate<T>(AddInProcess, PermissionSet) przeciążenia metody.

Plik wykonywalny, który uruchamia dodatek, jest uzyskiwany z jednego z dwóch plików zainstalowanych z .NET Framework w katalogu systemu Windows. Domyślnie używany jest plik wykonywalny zgodny z bitami na słowo aplikacji hosta. Jeśli host jest procesem 64-bitowym, AddInProcess.exe jest uruchamiany; w przeciwnym razie AddInProcess32.exe jest uruchamiana. Aby określić sposób wybrania pliku wykonywalnego, użyj konstruktora AddInProcess(Platform) do utworzenia AddInProcess obiektu.

Konstruktory

AddInProcess()	Inicjuje nowe wystąpienie klasy AddInProcess.
AddInProcess(Platform)	Inicjuje nowe wystąpienie AddInProcess klasy, określając bity na słowo procesu, w którym jest uruchamiany dodatek.

Właściwości

IsCurrentProcess	Pobiera wartość wskazującą, czy bieżący AddInProcess obiekt reprezentuje proces aplikacji hosta.
KeepAlive	Pobiera lub ustawia wartość wskazującą, czy proces zewnętrzny jest aktywny.
Platform	Pobiera bity na słowo procesu, w którym jest uruchamiany dodatek poza procesem.
ProcessId	Pobiera identyfikator procesu zewnętrznego.
StartupTimeout	Pobiera lub ustawia liczbę sekund, aby umożliwić rozpoczęcie procesu.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Shutdown()	Wymuszone zamknięcie procesu zewnętrznego.
Start()	Uruchamia proces zewnętrzny.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

ShuttingDown

Występuje, gdy proces reprezentowany przez AddInProcess obiekt ma zostać zamknięty.

Zobacz też

• Dodatki i rozszerzalność