Installer.Rollback(IDictionary) Méthode

  • Référence

Définition

Espace de noms:
System.Configuration.Install
Assembly:
System.Configuration.Install.dll

En cas de substitution dans une classe dérivée, restaure l'état de l'ordinateur préalable à l'installation.

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)

Paramètres

savedState
IDictionary

IDictionary qui contient l'état qui était celui de l'ordinateur avant l'installation.

Exceptions

ArgumentException

Le paramètre savedState a la valeur null.

- ou -

Il se peut que le IDictionary des états enregistrés ait été endommagé.

InstallException

Une exception s'est produite pendant la phase Rollback(IDictionary) de l'installation. Cette exception est ignorée et la restauration continue. Cependant, il se peut que l'ordinateur ne revienne pas totalement à son état initial une fois la restauration terminée.

Exemples

L’exemple suivant illustre la Rollback méthode de Installer. La Rollback méthode est remplacée dans la classe dérivée de Installer. Une exception est générée pour forcer la restauration d’une installation.

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

Notes pour les héritiers

Lorsque vous remplacez la Rollback(IDictionary) méthode dans une classe dérivée, veillez à appeler la méthode de la classe de Rollback(IDictionary) base en premier dans votre méthode dérivée. Une opération de restauration restaure l’ordinateur à l’état dans lequel il se trouvait avant les installations. La Rollback(IDictionary) méthode est appelée si la Install(IDictionary) méthode de cette instance de Installer, ou tout programme d’installation dans la collection du programme d’installation, ne s’exécute pas correctement. Toutes les exceptions générées en appelant les Rollback(IDictionary) méthodes des programmes d’installation dans la collection du programme d’installation sont ignorées et la restauration des autres programmes d’installation se poursuit.

S’applique à

Voir aussi