MessageQueueInstaller.Commit メソッド

.NET Framework クラス ライブラリ リファレンス

MessageQueueInstaller.Commit メソッド

Install メソッドによってレジストリに書き込まれた MessageQueue インストール情報をコミットして、インストール プロセスを完了します。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Commit
 ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim instance As MessageQueueInstaller
Dim savedState As IDictionary

instance.Commit(savedState)

C#

public override void Commit (
    IDictionary savedState
)

C++

public:
virtual void Commit (
    IDictionary^ savedState
) override

J#

public void Commit (
    IDictionary savedState
)

JScript

public override function Commit (
    savedState : IDictionary
)

パラメータ

savedState

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

解説

通常、コードからは MessageQueueInstaller のメソッドを呼び出しません。一般的に、このメソッドを呼び出すのはインストール ユーティリティの installutil.exe だけです。ユーティリティは、インストール プロセス中に、Install メソッドを自動的に呼び出します。インストールはトランザクションです。そのため、インストール中にインストール プロジェクト コンポーネントのいずれかが失敗した場合は、既にインストールされていたすべてのコンポーネントがインストール前の状態にロールバックされます。ロールバックは、各コンポーネントの Rollback メソッドを呼び出すことによって実行されます。

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

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
MessageQueueInstaller クラス
MessageQueueInstaller メンバ
System.Messaging 名前空間
Commit
Rollback
Uninstall