Installer.Rollback(IDictionary) Methode

Referenz

Definition

Namespace:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ArgumentException

Der savedState-Parameter ist null.

- oder -

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

InstallException

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 Installationsrollback 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. Ein Rollbackvorgang stellt den Computer in den Zustand zurück, in dem er sich vor der Installation befand. Die Rollback(IDictionary) -Methode wird aufgerufen, wenn die Install(IDictionary) Methode dieser instance von Installeroder eines beliebigen Installers in der Installerauflistung nicht ordnungsgemäß ausgeführt werden kann. Alle Ausnahmen, die durch das Aufrufen der Rollback(IDictionary) Methoden der Installer in der Installerauflistung generiert werden, werden ignoriert, und das Rollback der anderen Installationsprogramme wird fortgesetzt.

Gilt für: