AssemblyInstaller.Rollback メソッド

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

AssemblyInstaller.Rollback メソッド

コンピュータをインストール前の状態に復元します。

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

Visual Basic (宣言)

Public Overrides Sub Rollback
 ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim instance As AssemblyInstaller
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。

例外

例外の種類	条件
ArgumentException	savedState パラメータが null 参照 (Visual Basic では Nothing) です。 または 状態を保存している IDictionary が破損している可能性があります。 または ファイルが見つかりませんでした。
Exception	コレクション内にあるインストーラのうちの 1 つのインストーラの BeforeRollback イベント ハンドラで例外が発生しました。 または コレクション内にあるインストーラのうちの 1 つのインストーラの AfterRollback イベント ハンドラで例外が発生しました。 または インストールの Rollback フェーズで例外が発生しました。この例外は無視され、ロールバックが続行されます。ただし、ロールバックが完了しても、コンピュータが完全には初期状態に復元されない可能性があります。 または アセンブリのうちの 1 つで、インストーラの型が見つかりませんでした。 または インストーラの型のうちの 1 つについて、インスタンスを作成できませんでした。
InstallException	インストールの Rollback フェーズで例外が発生しました。この例外は無視され、ロールバックが続行されます。ただし、ロールバックが完了しても、コンピュータが完全には初期状態に復元されない可能性があります。

解説

ロールバックとは、インストールの実行前の状態にコンピュータを復元することです。Rollback メソッドは、Installer インスタンスまたはインストーラ コレクション内の任意のインストーラの Install メソッドが正常に実行されなかった場合に呼び出されます。コレクション内のインストーラの Rollback メソッドを呼び出すことによって生成された例外はすべて無視され、他のインストーラのロールバックが続行されます。

使用例

指定したアセンブリのインストール プロセスを元に戻すために、Rollback メソッドを呼び出すサンプルを次に示します。

Visual Basic

' 'Rollback' the installation process.
myAssemblyInstaller.Rollback(mySavedState)

C#

// 'Rollback' the installation process.
myAssemblyInstaller.Rollback( mySavedState );

C++

// 'Rollback' the installation process.
myAssemblyInstaller->Rollback( mySavedState );

J#

// 'Rollback' the installation process.
myAssemblyInstaller.Rollback(mySavedState);

.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

参照

関連項目
AssemblyInstaller クラス
AssemblyInstaller メンバ
System.Configuration.Install 名前空間