EventLogInstaller.Rollback メソッド

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

EventLogInstaller.Rollback メソッド

インストール プロシージャがレジストリに書き込んだイベント ログ情報をロールバックして、コンピュータをインストール前の状態に復元します。

名前空間: System.Diagnostics
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Rollback
 ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim instance As EventLogInstaller
Dim savedState As IDictionary

instance.Rollback(savedState)

C#

public override void Rollback (
    IDictionary savedState
)

C++

public:
virtual void Rollback (
    IDictionary^ savedState
) override

J#

public void Rollback (
    IDictionary savedState
)

JScript

public override function Rollback (
    savedState : IDictionary
)

パラメータ

savedState

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

解説

Rollback メソッドは、Install メソッドの反映内容を元の内容に戻します。Rollback は、インストール プロジェクトのいずれかのコンポーネントのインストールが失敗した場合に呼び出されます。Install メソッドは、イベント ログとイベント ソースのプロパティを作成または設定します。Rollback は、イベント ログとソースを削除するか、既存のソースのプロパティをインストール前の値にリセットします。

通常、コードからは EventLogInstaller のメソッドを呼び出しません。このメソッドを呼び出すのは、一般的にインストーラ ツール (Installutil.exe) だけです。このツールは、インストール時にこのコンポーネントまたは別のコンポーネントをインストールできなかった場合に Rollback メソッドを呼び出して、インストール処理が既に加えた変更を元に戻します。

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

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
EventLogInstaller クラス
EventLogInstaller メンバ
System.Diagnostics 名前空間
Install
Uninstall
IDictionary