次の方法で共有

AssemblyInstaller.Rollback メソッド

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

Overrides Public Sub Rollback( _
   ByVal savedState As IDictionary _)
[C#]
public override void Rollback(IDictionarysavedState);
[C++]
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 メソッドを呼び出すことによって生成された例外はすべて無視され、他のインストーラのロールバックが続行されます。

使用例

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

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

[C#] 
// 'Rollback' the installation process.
myAssemblyInstaller.Rollback( mySavedState );

[C++] 
// 'Rollback' the installation process.
myAssemblyInstaller->Rollback(mySavedState);

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

AssemblyInstaller クラス | AssemblyInstaller メンバ | System.Configuration.Install 名前空間