Cuando se reemplaza en una clase derivada, restaura el estado en el que estaba el equipo antes de la instalación.
Espacio de nombres: System.Configuration.Install
Ensamblado: System.Configuration.Install (en system.configuration.install.dll)
Sintaxis
Visual Basic (Declaración)
Public Overridable Sub Rollback ( _
savedState As IDictionary _
)
Dim instance As Installer
Dim savedState As IDictionary
instance.Rollback(savedState)
public virtual void Rollback (
IDictionary savedState
)
public:
virtual void Rollback (
IDictionary^ savedState
)
public void Rollback (
IDictionary savedState
)
public function Rollback (
savedState : IDictionary
)
Parámetros
- savedState
IDictionary que contiene el estado del equipo previo a la instalación.
Excepciones
| Tipo de excepción | Condición |
|---|
ArgumentException | El parámetro savedState es referencia de objeto null (Nothing en Visual Basic). O bien El IDictionary de estados guardados puede estar dañado. |
InstallException | Se ha producido una excepción durante la fase Rollback de la instalación. Se omite esta excepción y continúa la operación de deshacer. Sin embargo, puede que el equipo no haya vuelto por completo a su estado inicial una vez finalizada la operación de deshacer. |
Comentarios
Notas para los herederos
Si se reemplaza el método
Rollback en una clase derivada, hay que asegurarse de llamar primero al método
Rollback de la clase base en el método derivado. Una acción de deshacer restaura el estado en el que estaba el equipo antes de producirse la instalación. Se llama al método
Rollback si no se ejecuta correctamente el método
Install de esta instancia de
Installer o de cualquier instalador en la colección de instaladores. Se omiten todas las excepciones generadas al llamar a los métodos
Rollback de los instaladores que forman parte de la colección de instaladores y continúa la operación de deshacer de los otros instaladores.
Ejemplo
En el siguiente ejemplo se muestra el método Rollback de Installer. El método Rollback se reemplaza en la clase derivada de Installer. Se genera una excepción para obligar a que se deshaga la instalación.
' 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 'Rollback
// 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:
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 void Rollback(IDictionary mySavedState)
{
super.Rollback(mySavedState);
Console.WriteLine("The Rollback method of 'MyInstallerSample'"
+ " has been called");
} //Rollback
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea .
Plataformas
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
Información de versión
.NET Framework
Compatible con: 2.0, 1.1, 1.0
Vea también