Installer.Rollback(IDictionary) Método
Definição
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
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.