Installer.Rollback メソッド

.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)

C#

public virtual void Rollback (
    IDictionary savedState
)

C++

public:
virtual void Rollback (
    IDictionary^ savedState
)

J#

public void Rollback (
    IDictionary savedState
)

JScript

public function Rollback (
    savedState : IDictionary
)

パラメータ

savedState

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

例外

例外の種類	条件
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

C#

// 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" );
   }

J#

// 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

.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

参照

関連項目
Installer クラス
Installer メンバ
System.Configuration.Install 名前空間
Commit
Uninstall
Install
InstallerCollection
Installers