MessageQueueInstaller.Commit(IDictionary) メソッド

public:
 override void Commit(System::Collections::IDictionary ^ savedState);

public override void Commit(System.Collections.IDictionary savedState);

override this.Commit : System.Collections.IDictionary -> unit

Public Overrides Sub Commit (savedState As IDictionary)

パラメーター

注釈

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

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

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

こちらもご覧ください

• Commit(IDictionary)
• Rollback(IDictionary)
• Uninstall(IDictionary)