MessageQueueInstaller.Commit(IDictionary) メソッド

  • リファレンス

定義

名前空間:
System.Messaging
アセンブリ:
System.Messaging.dll

MessageQueue メソッドによってレジストリに書き込まれた Install(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)

パラメーター

savedState
IDictionary

インストール後のコンピューターの状態を格納している IDictionary。

注釈

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

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

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

適用対象

こちらもご覧ください