Installer.Rollback(IDictionary) Methode
Definition
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.
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, wird der Vorinstallationsstatus des Computers wiederhergestellt.
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 -> unitPublic Overridable Sub Rollback (savedState As IDictionary)Parameter
- savedState
- IDictionary
Eine IDictionary , die den Vorinstallationsstatus des Computers enthält.
Ausnahmen
Der savedState Parameter ist null.
-oder-
Möglicherweise ist der gespeicherte Zustand IDictionary beschädigt.
Ausnahme während der Rollback(IDictionary) Phase der Installation. Diese Ausnahme wird ignoriert, und der Rollback wird fortgesetzt. Der Computer wird jedoch nach Abschluss des Rollbacks möglicherweise nicht vollständig in den Anfangszustand zurückgesetzt.
Beispiele
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 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 die Methode der Basisklasse Rollback(IDictionary) zuerst in der abgeleiteten Methode aufrufen. Ein Rollbackvorgang stellt den Computer in den Zustand wieder her, in dem er sich befand, bevor die Installationen aufgetreten sind. Die Rollback(IDictionary) Methode wird aufgerufen, wenn die Install(IDictionary) Methode dieser Instanz oder Installereines Installationsprogramms in der Installer-Auflistung nicht ordnungsgemäß ausgeführt werden kann. Alle Ausnahmen, die durch Aufrufen der Rollback(IDictionary) Methoden der Installationsprogramme in der Installer-Auflistung generiert werden, werden ignoriert, und das Rollback der anderen Installationsprogramme wird fortgesetzt.