Installer.Rollback(IDictionary) Methode

Definition

Stellt beim Überschreiben in einer abgeleiteten Klasse den Zustand wieder her, in dem sich der Computer vor der Installation befand.When overridden in a derived class, restores the pre-installation state of the computer.

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)

Parameter

savedState
IDictionary

Ein IDictionary, das Informationen über den Zustand enthält, in dem sich der Computer vor der Installation befand.An IDictionary that contains the pre-installation state of the computer.

Ausnahmen

Der savedState-Parameter ist null.The savedState parameter is null.

- oder --or- Das IDictionary mit dem gespeicherten Zustand ist möglicherweise beschädigt.The saved-state IDictionary might have been corrupted.

Während der Rollback(IDictionary)-Phase der Installation ist eine Ausnahme aufgetreten.An exception occurred during the Rollback(IDictionary) phase of the installation. Diese Ausnahme wird ignoriert, und der Rollback wird fortgesetzt.This exception is ignored and the rollback continues. Nach Abschluss des Rollbacks ist der Computer jedoch möglicherweise nicht vollständig auf den ursprünglichen Zustand zurückgesetzt.However, the computer might not be fully reverted to its initial state after the rollback completes.

Beispiele

Im folgenden Beispiel wird die Rollback -Methode Installervon veranschaulicht.The following example demonstrates the Rollback method of Installer. Die Rollback -Methode wird in der abgeleiteten Klasse von Installerüberschrieben.The Rollback method is overridden in the derived class of Installer. Eine Ausnahme wird generiert, um ein Installations Rollback zu erzwingen.An exception is generated to force an installation rollback.

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

Hinweise für Vererber

Wenn Sie die Rollback(IDictionary) Methode in einer abgeleiteten Klasse überschreiben, stellen Sie sicher, dass Sie Rollback(IDictionary) die-Methode der Basisklasse zuerst in der abgeleiteten Methode aufruft.When you override the Rollback(IDictionary) method in a derived class, be sure to call the base class's Rollback(IDictionary) method first in your derived method. Durch einen Rollback-Vorgang wird der Computer in dem Zustand wieder hergestellt, in dem er sich vor der Installation befand.A rollback operation restores the computer to the state it was in before the installations occurred. Die Rollback(IDictionary) -Methode wird aufgerufen, Install(IDictionary) wenn die-Methode dieser InstallerInstanz von oder eines beliebigen Installers in der Installer-Auflistung nicht ordnungsgemäß ausgeführt werden kann.The Rollback(IDictionary) method is called if the Install(IDictionary) method of this instance of Installer, or any installer in the installer collection, fail to run correctly. Alle Ausnahmen, die durch das Rollback(IDictionary) Aufrufen der Methoden der Installationsprogramme in der Installer-Auflistung generiert werden, werden ignoriert, und das Rollback der anderen Installationsprogramme wird fortgesetzt.Any exceptions generated by calling the Rollback(IDictionary) methods of the installers in the installer collection are ignored and the rollback of the other installers continues.

Gilt für:

Siehe auch