AddInProcess 類別

定義

命名空間:

System.AddIn.Hosting

組件:

System.AddIn.dll

提供外部處理序，以便從主應用程式跨處理序執行增益集。

public ref class AddInProcess sealed

public sealed class AddInProcess

type AddInProcess = class

Public NotInheritable Class AddInProcess

繼承

Object

AddInProcess

範例

下列範例會在外部進程中啟動載入宏。

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

備註

若要在外部進程中啟用載入宏，請將 對象傳遞 AddInProcess 至適當的 AddInToken.Activate<T>(AddInProcess, PermissionSet) 方法多載。

執行載入宏的可執行檔是從 Windows 目錄下 .NET Framework 安裝的兩個檔案之一取得。 根據預設，會使用符合主應用程式每個字組位的可執行檔。 如果主機是64位進程，則會執行 AddInProcess.exe;否則，會執行 AddInProcess32.exe。 若要指定選取可執行檔的方式，請使用 建 AddInProcess(Platform) 構函式來建立 AddInProcess 物件。

建構函式

AddInProcess()	初始化 AddInProcess 類別的新執行個體。
AddInProcess(Platform)	指定增益集執行所在處理序的每個字組位元數，初始化 AddInProcess 類別的新執行個體。

屬性

IsCurrentProcess	取得值，指出目前的 AddInProcess 物件是否代表主機應用程式處理序。
KeepAlive	取得或設定值，這個值表示是否讓外部處理序持續作用。
Platform	取得執行跨處理序增益集之處理序的每個字組位元數。
ProcessId	取得外部處理序的處理序 ID。
StartupTimeout	取得或設定允許處理序啟動的秒數。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Shutdown()	強制關閉外部處理序。
Start()	啟動外部處理序。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

ShuttingDown

當 AddInProcess 物件所表示的處理序即將關閉時發生。

另請參閱

• 載入宏和擴充性