Installer.Rollback(IDictionary) Installer.Rollback(IDictionary) Installer.Rollback(IDictionary) Installer.Rollback(IDictionary) Method

Definição

Quando substituído em uma classe derivada, restaura o estado de pré-instalação do computador.When overridden in a derived class, restores the pre-installation state of the computer.

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

Um IDictionary que contém o estado de pré-instalação do computador.An IDictionary that contains the pre-installation state of the computer.

Exceções

O parâmetro savedState é null.The savedState parameter is null.

- ou --or- O IDictionary de estado salvo pode estar corrompido.The saved-state IDictionary might have been corrupted.

Ocorreu uma exceção durante a fase Rollback(IDictionary) da instalação.An exception occurred during the Rollback(IDictionary) phase of the installation. Essa exceção é ignorada e a reversão continua.This exception is ignored and the rollback continues. No entanto, o computador pode não ser totalmente revertido para seu estado inicial após a conclusão da reversão.However, the computer might not be fully reverted to its initial state after the rollback completes.

Exemplos

O exemplo a seguir demonstra Rollback o método Installerde.The following example demonstrates the Rollback method of Installer. O Rollback método é substituído na classe derivada de Installer.The Rollback method is overridden in the derived class of Installer. Uma exceção é gerada para forçar uma reversão de instalação.An exception is generated to force an installation rollback.

   // 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 primeiro o método da Rollback(IDictionary) classe base em seu método derivado.When you override the Rollback(IDictionary) method in a derived class, be sure to call the base class's Rollback(IDictionary) method first in your derived method. Uma operação de reversão restaura o computador para o estado em que estava antes da ocorrência das instalações.A rollback operation restores the computer to the state it was in before the installations occurred. O Rollback(IDictionary) método é chamado se o Install(IDictionary) método dessa instância do Installerou de qualquer instalador na coleção do instalador falhar ao ser executado corretamente.The Rollback(IDictionary) method is called if the Install(IDictionary) method of this instance of Installer, or any installer in the installer collection, fail to run correctly. Todas as exceções geradas chamando Rollback(IDictionary) os métodos dos instaladores na coleção do instalador são ignoradas e a reversão dos outros instaladores continua.Any exceptions generated by calling the Rollback(IDictionary) methods of the installers in the installer collection are ignored and the rollback of the other installers continues.

Aplica-se a

Veja também