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)

注釈

外部プロセスでアドインをアクティブ化するには、オブジェクトを適切なAddInProcessAddInToken.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 オブジェクトによって表されるプロセスが終了する直前に発生します。

適用対象

こちらもご覧ください