Installer.Rollback メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Installer.Rollback メソッド

派生クラスによってオーバーライドされた場合、インストール前のコンピュータの状態を復元します。

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

Visual Basic (宣言)

Public Overridable Sub Rollback
 ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim instance As Installer
Dim savedState As IDictionary

instance.Rollback(savedState)

public virtual void Rollback (
    IDictionary savedState
)

C++

public:
virtual void Rollback (
    IDictionary^ savedState
)

public void Rollback (
    IDictionary savedState
)

JScript

public function Rollback (
    savedState : IDictionary
)

パラメータ

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

例外

例外の種類	条件
ArgumentException	savedState パラメータが null 参照 (Visual Basic では Nothing) です。または状態を保存している IDictionary が破損している可能性があります。
InstallException	インストールの Rollback フェーズで例外が発生しました。この例外は無視され、ロールバックが続行されます。ただし、ロールバックが完了しても、コンピュータが完全には初期状態に復元されない可能性があります。

例外の種類

条件

ArgumentException

savedState パラメータが null 参照 (Visual Basic では Nothing) です。

または

状態を保存している IDictionary が破損している可能性があります。

InstallException

インストールの Rollback フェーズで例外が発生しました。この例外は無視され、ロールバックが続行されます。ただし、ロールバックが完了しても、コンピュータが完全には初期状態に復元されない可能性があります。

解説

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

使用例

Installer の Rollback メソッドの例を次に示します。Rollback メソッドは、Installer の派生クラスでオーバーライドされます。インストールを強制的にロールバックするために、例外が生成されます。

Visual Basic

' Override 'Rollback' method of Installer class.
Public Overrides Sub Rollback(mySavedState
 As IDictionary)
   MyBase.Rollback(mySavedState)
   Console.WriteLine("The Rollback method of 'MyInstallerSample'"
 + _
                                                " has been called")
End Sub 'Rollback

// Override 'Rollback' method of Installer class.
public override void Rollback( IDictionary
 mySavedState )
{
   base.Rollback( mySavedState );
   Console.WriteLine( "The Rollback method of 'MyInstallerSample'" +
                     " has been called" );
}

C++

   // Override 'Rollback' method of Installer class.
public:
   virtual void Rollback( IDictionary^ mySavedState ) override
   {
      Installer::Rollback( mySavedState );
      Console::WriteLine( "The Rollback method of 'MyInstallerSample'"
 +
                         " has been called" );
   }

// Override 'Rollback' method of Installer class.
public void Rollback(IDictionary mySavedState)
{
    super.Rollback(mySavedState);
    Console.WriteLine("The Rollback method of 'MyInstallerSample'" 
        + " has been called");
} //Rollback