AssemblyInstaller.Rollback(IDictionary) Methode

Definition

Namespace:

System.Configuration.Install

Assembly:

System.Configuration.Install.dll

Stellt den Zustand wieder her, in dem sich der Computer vor der Installation befand.

public:
 override void Rollback(System::Collections::IDictionary ^ savedState);

public override void Rollback (System.Collections.IDictionary savedState);

override this.Rollback : System.Collections.IDictionary -> unit

Public Overrides 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.

- oder -

Eine Datei konnte nicht gefunden werden.

Exception

Im BeforeRollback-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.

- oder -

Im AfterRollback-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.

- oder -

Während der Rollback(IDictionary)-Phase der Installation ist eine Ausnahme aufgetreten. Die 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.

- oder -

In einer der Assemblys wurden keine Installationsprogrammtypen gefunden.

- oder -

Für einen der Installationsprogrammtypen konnte keine Instanz erstellt werden.

InstallException

Während der Rollback(IDictionary)-Phase der Installation ist eine Ausnahme aufgetreten. Die 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 aufgerufen, um den Installationsvorgang für die angegebene Assembly rückgängig zu machen.

// 'Rollback' the installation process.
myAssemblyInstaller->Rollback( mySavedState );

// 'Rollback' the installation process.
myAssemblyInstaller.Rollback( mySavedState );

' 'Rollback' the installation process.
myAssemblyInstaller.Rollback(mySavedState)

Hinweise

Bei einem Rollback wird der Computer in den Zustand versetzt, in dem er sich vor der Installation befand. Die Rollback -Methode wird aufgerufen, wenn die Install -Methode dieses Installer instance oder eines Installationsprogramms in der Installerauflistung nicht ordnungsgemäß ausgeführt werden kann. Alle Ausnahmen, die durch Aufrufen der Rollback -Methode eines Installationsprogramms in der Auflistung generiert werden, werden ignoriert, und das Rollback der anderen Installationsprogramme wird fortgesetzt.