MessageQueueInstaller.Install(IDictionary) メソッド

定義

インストールを実行し、レジストリにメッセージ キュー情報を書き込みます。 このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。

public:
 override void Install(System::Collections::IDictionary ^ stateSaver);
public override void Install (System.Collections.IDictionary stateSaver);
override this.Install : System.Collections.IDictionary -> unit
Public Overrides Sub Install (stateSaver As IDictionary)

パラメーター

stateSaver
IDictionary

コミット、ロールバック、またはアンインストール操作を実行するために必要な情報を保存するために使用する IDictionary

注釈

メソッドはInstall、メッセージ キュー情報をレジストリに書き込み、 プロパティで指定されたパスにあるキューにインスタンスをPath関連付けますMessageQueue。 キューがまだ存在しない場合は、 Install トランザクション キューを作成します。 Install は、新規または既存のキュー プロパティを、 で指定したキュー プロパティに MessageQueueInstaller設定します。 キューが既に存在する場合、そのプロパティは の MessageQueueInstallerプロパティにリセットされます。 既存のキューがトランザクションでない場合は、削除され、トランザクション キューとして再作成されます。

注意事項

キューを再作成する必要がある場合、キュー内のメッセージは失われます。

通常、コード内から の MessageQueueInstaller メソッドを呼び出すわけではありません。通常は、installutil.exe インストール ユーティリティによってのみ呼び出されます。 ユーティリティは、インストール処理中に メソッドを Install 自動的に呼び出して、インストールされているメッセージ キューに関連付けられているレジストリ情報を書き込みます。 インストールはトランザクションであるため、インストール中にインストール プロジェクト コンポーネントに障害が発生した場合は、以前にインストールされたすべてのコンポーネントがインストール前の状態にロールバックされます。 これは、各コンポーネントの Rollback メソッドを呼び出すことによって実現されます。

インストール プロジェクトに関連付けられているすべてのコンポーネントが正常にインストールされると、インストール ユーティリティによってインストールがコミットされます。 Commit は、キューを適切な初期状態に設定して のインストール MessageQueue を完了します。 プロパティで指定されたキューが既に Path 存在し、メッセージが含まれている場合は、 Commit メッセージをクリアします。 Commitではなく Install、メッセージを消去します。これは、メッセージを消去する操作をロールバックできないためです。

アプリケーションのインストール ルーチンでは、プロジェクト インストーラーを Installer.Context 使用して、既にインストールされているコンポーネントに関する情報が自動的に保持されます。 パラメーターとして stateSaver に渡されるInstallこの状態情報は、ユーティリティが各MessageQueueInstallerインスタンスをインストールすると継続的に更新されます。 通常、コードでこの状態情報を明示的に変更する必要はありません。

適用対象

こちらもご覧ください