Installer.Rollback(IDictionary) Método

Referência

Definição

Namespace:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

ArgumentException

O parâmetro savedState é null.

- ou -

O IDictionary de estado salvo pode estar corrompido.

InstallException

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