ServiceProcessInstaller.Rollback(IDictionary) メソッド

定義

名前空間:

System.ServiceProcess

アセンブリ:

System.ServiceProcess.dll

インストール プロシージャによってレジストリに書き込まれたサービス アプリケーション情報をロールバックします。 このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に処理します。

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

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

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

Public Overrides Sub Rollback (savedState As IDictionary)

パラメーター

savedState

IDictionary

インストールに関連付けられているコンテキスト情報を格納する IDictionary。

例外

ArgumentException

savedState が null です。

- または -

savedState が、破損しているか存在していません。

注釈

通常、コード内で メソッド ServiceProcessInstaller を呼び出すわけではありません。通常、これらはインストール ユーティリティによってのみ呼び出されます。 インストール ユーティリティは、インストール プロセス中に メソッドを ServiceProcessInstaller.Install 自動的に呼び出します。 例外を生成した オブジェクトに対して を呼び出 Rollback すことで、必要に応じてエラーをバックアウトします。

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

Rollback は、基底クラスのメソッドまたは BeforeInstall / AfterInstall イベント ハンドラーによってスローされた例外を呼び出し元のメソッドに渡します。

こちらもご覧ください

• Install(IDictionary)
• ComponentInstaller