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 对象所表示的进程即将关闭时发生。

另请参阅

• 加载项和扩展性