Partilhar via


Installer.Rollback(IDictionary) Método

Definição

Quando substituído em uma classe derivada, restaura o estado de pré-instalação do computador.

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)

Parâmetros

savedState
IDictionary

Um IDictionary que contém o estado de pré-instalação do computador.

Exceções

O parâmetro savedState é null.

- ou -

O IDictionary de estado salvo pode estar corrompido.

Ocorreu uma exceção durante a fase Rollback(IDictionary) da instalação. Essa exceção é ignorada e a reversão continua. No entanto, o computador pode não ser totalmente revertido para seu estado inicial após a conclusão da reversão.

Exemplos

O exemplo a seguir demonstra o Rollback método de Installer. O Rollback método é substituído na classe derivada de Installer. Uma exceção é gerada para forçar uma reversão de instalação.

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

Notas aos Herdeiros

Ao substituir o Rollback(IDictionary) método em uma classe derivada, certifique-se de chamar o método da Rollback(IDictionary) classe base primeiro em seu método derivado. Uma operação de reversão restaura o computador para o estado em que estava antes das instalações ocorrerem. O Rollback(IDictionary) método será chamado se o Install(IDictionary) método dessa instância do Installerou qualquer instalador na coleção do instalador falhar ao ser executado corretamente. Todas as exceções geradas chamando os Rollback(IDictionary) métodos dos instaladores na coleção do instalador são ignoradas e a reversão dos outros instaladores continua.

Aplica-se a

Confira também