Installer.Rollback(IDictionary) Méthode

Référence

Définition

Espace de noms:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 Rollback(IDictionary) la classe de 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 que les installations ne se produisent. La Rollback(IDictionary) méthode est appelée si la Install(IDictionary) méthode de cette instance de Installer, ou tout programme d’installation de la collection 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 d’installation sont ignorées et la restauration des autres programmes d’installation continue.

S’applique à