Installer.Rollback(IDictionary) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Configuration.Install

Zestaw:: System.Configuration.Install.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Po przesłonięciu w klasie pochodnej przywraca stan przed instalacją komputera.

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)

Parametry

savedState: IDictionary

Element IDictionary zawierający stan wstępnej instalacji komputera.

Wyjątki

ArgumentException

Parametr savedState to null.

-lub-

Zapisany stan IDictionary mógł zostać uszkodzony.

InstallException

Wystąpił wyjątek podczas Rollback(IDictionary) fazy instalacji. Ten wyjątek jest ignorowany, a wycofywanie będzie kontynuowane. Jednak po zakończeniu wycofywania komputer może nie zostać w pełni przywrócony do stanu początkowego.

Przykłady

W poniższym przykładzie pokazano metodę Rollback .Installer Metoda Rollback jest zastępowana w klasie pochodnej klasy Installer. Zostanie wygenerowany wyjątek, aby wymusić wycofanie instalacji.

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

Uwagi dotyczące dziedziczenia

Po zastąpieniu Rollback(IDictionary) metody w klasie pochodnej należy najpierw wywołać metodę klasy Rollback(IDictionary) bazowej w metodzie pochodnej. Operacja wycofywania przywraca komputer do stanu, w który znajdował się przed wystąpieniem instalacji. Metoda jest wywoływana Rollback(IDictionary) , jeśli Install(IDictionary) metoda tego wystąpienia programu Installerlub dowolnego instalatora w kolekcji instalatora zakończy się niepowodzeniem. Wszelkie wyjątki generowane przez wywołanie Rollback(IDictionary) metod instalatorów w kolekcji instalatora są ignorowane i wycofywanie innych instalatorów jest kontynuowane.

Dotyczy