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.

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-Objekt, das Informationen über den Zustand enthält, in dem sich der Computer vor der Installation befand.

Ausnahmen

Der savedState-Parameter ist null.

- oder -

Das IDictionary mit dem gespeicherten Zustand ist möglicherweise beschädigt.

Während der Rollback(IDictionary)-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.

Beispiele

Im folgenden Beispiel wird die Rollback -Methode von Installerveranschaulicht. Die Rollback -Methode wird in der abgeleiteten Klasse von überschrieben Installer. Es wird eine Ausnahme generiert, um ein Rollback für die Installation zu erzwingen.

   // 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, müssen Sie zuerst die -Methode der Basisklasse Rollback(IDictionary) in Ihrer abgeleiteten Methode aufrufen. Bei einem Rollbackvorgang wird der Computer in dem Zustand wiederhergestellt, in dem er sich vor der Installation befunden hat. Die Rollback(IDictionary) -Methode wird aufgerufen, wenn die Install(IDictionary) -Methode dieser Instanz von Installeroder eines beliebigen Installationsprogramms in der Installerauflistung nicht ordnungsgemäß ausgeführt werden kann. Alle Ausnahmen, die durch aufrufen der Rollback(IDictionary) Methoden der Installationsprogramme in der Installerauflistung generiert werden, werden ignoriert, und das Rollback der anderen Installationsprogramme wird fortgesetzt.

Gilt für:

Weitere Informationen