Installer.Rollback-Methode

Stellt beim Überschreiben in einer abgeleiteten Klasse den Zustand wieder her, in dem sich der Computer vor der Installation befand.

Namespace: System.Configuration.Install
Assembly: System.Configuration.Install (in system.configuration.install.dll)

Syntax

'Declaration
Public Overridable Sub Rollback ( _
    savedState As IDictionary _
)
'Usage
Dim instance As Installer
Dim savedState As IDictionary

instance.Rollback(savedState)

public virtual void Rollback (
    IDictionary savedState
)

public:
virtual void Rollback (
    IDictionary^ savedState
)

public void Rollback (
    IDictionary savedState
)

public function Rollback (
    savedState : IDictionary
)

Parameter

• savedState
  Ein IDictionary, das Informationen zu dem Zustand enthält, in dem sich der Computer vor der Installation befand.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der savedState-Parameter ist NULL (Nothing in Visual Basic). – oder – Das IDictionary mit dem gespeicherten Zustand ist möglicherweise beschädigt.
InstallException	Während der Rollback-Phase der Installation ist eine Ausnahme aufgetreten. Diese Ausnahme wird ignoriert, und der Rollback wird fortgesetzt. Nach Abschluss des Rollbacks ist der Computer jedoch möglicherweise nicht vollständig auf den ursprünglichen Zustand zurückgesetzt.

Hinweise

Hinweise für Erben Wenn Sie die Rollback-Methode in einer abgeleiteten Klasse überschreiben, müssen Sie in der abgeleiteten Methode unbedingt zuerst die Rollback-Methode der Basisklasse aufrufen. Ein Rollbackvorgang stellt den Zustand wieder her, in dem sich der Computer vor der Installation befand. Die Rollback-Methode wird aufgerufen, wenn die Install-Methode dieser Installer-Instanz oder eines der Installationsprogramme in der entsprechenden Auflistung nicht ordnungsgemäß ausgeführt wird. Alle Ausnahmen, die durch den Aufruf der Rollback-Methoden für die Installationsprogramme in der Auflistung von Installationsprogrammen ausgelöst wurden, werden ignoriert, und der Rollback der anderen Installationsprogramme wird fortgesetzt.

Beispiel

Das folgende Beispiel veranschaulicht die Rollback-Methode von Installer. Die Rollback-Methode wird in der abgeleiteten Klasse von Installer überschrieben. Eine Ausnahme wird generiert, um ein Rollback der Installation zu erzwingen.

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

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

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Installer-Klasse
Installer-Member
System.Configuration.Install-Namespace
Commit
Uninstall
Install
InstallerCollection
Installers