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 programem .NET Framework w katalogu 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 uruchamiany. Aby określić sposób wybierania pliku wykonywalnego, użyj AddInProcess(Platform) konstruktora do utworzenia AddInProcess obiektu.

Konstruktory

Nazwa	Opis
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

Nazwa	Opis
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 będzie 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

Nazwa	Opis
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()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (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

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