AddInProcess クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ホスト アプリケーションからアウトプロセスでアドインを実行するための外部プロセスを提供します。
public ref class AddInProcess sealed
public sealed class AddInProcess
type AddInProcess = class
Public NotInheritable Class AddInProcess
- 継承
-
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 と共にインストールされた 2 つのファイルのいずれかから取得されます。 既定では、ホスト アプリケーションの単語ごとのビット数に一致する実行可能ファイルが使用されます。 ホストが 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 オブジェクトによって表されるプロセスがシャットダウンされるときに発生します。 |