Installer.Rollback(IDictionary) メソッド

  • リファレンス

定義

名前空間:
System.Configuration.Install
アセンブリ:
System.Configuration.Install.dll

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

public:
 virtual void Rollback(System::Collections::IDictionary ^ savedState);
public virtual void Rollback (System.Collections.IDictionary savedState);
abstract member Rollback : System.Collections.IDictionary -> unit
override this.Rollback : System.Collections.IDictionary -> unit
Public Overridable Sub Rollback (savedState As IDictionary)

パラメーター

savedState
IDictionary

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

例外

ArgumentException

savedState パラメーターが null です。

- または -

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

InstallException

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

例

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

   // 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 override void Rollback( IDictionary mySavedState )
{
   base.Rollback( mySavedState );
   Console.WriteLine( "The Rollback method of 'MyInstallerSample'" +
                     " has been called" );
}

' 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(IDictionary) オーバーライドする場合は、必ず派生メソッドで最初に基底クラスの Rollback(IDictionary) メソッドを呼び出してください。 ロールバック操作を実行すると、インストールが発生する前の状態にコンピューターが復元されます。 のRollback(IDictionary)このインスタンスInstallerの メソッド、またはインストーラー コレクション内のインストーラーが正しく実行されない場合Install(IDictionary)は、 メソッドが呼び出されます。 インストーラー コレクション内のインストーラーのメソッドを Rollback(IDictionary) 呼び出すことによって生成された例外はすべて無視され、他のインストーラーのロールバックは続行されます。

適用対象

こちらもご覧ください