MessageQueueInstaller.Install(IDictionary) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
インストールを実行し、メッセージ キュー情報をレジストリに書き込みます。 このメソッドは、適切なメソッドを自動的に呼び出すインストール ツールで使用するためのものです。
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install(System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)パラメーター
- stateSaver
- IDictionary
コミット、ロールバック、またはアンインストール操作を実行するために必要な情報を保存するために使用される IDictionary 。
注釈
Install メソッドは、メッセージ キュー情報をレジストリに書き込み、MessageQueue インスタンスを、Path プロパティで指定されたパスにあるキューに関連付けます。 キューがまだ存在しない場合は、トランザクション キュー Install 作成されます。 Install は、新規または既存のキューのプロパティを、 MessageQueueInstallerで指定したプロパティに設定します。 キューが既に存在する場合、そのプロパティは MessageQueueInstallerのプロパティにリセットされます。 既存のキューがトランザクションでない場合は、削除され、トランザクション キューとして再作成されます。
Caution
キューを再作成する必要がある場合、キュー内のメッセージは失われます。
通常、コード内から MessageQueueInstaller のメソッドは呼び出しません。通常、installutil.exe インストール ユーティリティによってのみ呼び出されます。 このユーティリティは、インストールプロセス中に Install メソッドを自動的に呼び出して、インストールされているメッセージ キューに関連付けられているレジストリ情報を書き込みます。 インストールはトランザクションであるため、インストール中にインストール プロジェクト コンポーネントに障害が発生した場合、以前にインストールされたすべてのコンポーネントは、インストール前の状態にロールバックされます。 これは、各コンポーネントの Rollback メソッドを呼び出すことによって実現されます。
インストール プロジェクトに関連付けられているすべてのコンポーネントが正常にインストールされると、インストール ユーティリティによってインストールがコミットされます。 Commit は、キューを適切な初期状態に設定して、 MessageQueue のインストールを完了します。 Path プロパティで指定されたキューが既に存在し、メッセージが含まれている場合、Commitはメッセージをクリアします。 Commitは、 Installではなく、メッセージを消去します。これは、メッセージを消去する操作をロールバックできないためです。
アプリケーションのインストール ルーチンは、プロジェクト インストーラーの Installer.Context を使用して、既にインストールされているコンポーネントに関する情報を自動的に保持します。 この状態情報は、Install パラメーターとしてstateSaverに渡され、ユーティリティが各MessageQueueInstaller インスタンスをインストールすると継続的に更新されます。 通常、コードでこの状態情報を明示的に変更する必要はありません。
