Installer.Install(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, exécute l'installation.

public:
 virtual void Install(System::Collections::IDictionary ^ stateSaver);
public virtual void Install (System.Collections.IDictionary stateSaver);
abstract member Install : System.Collections.IDictionary -> unit
override this.Install : System.Collections.IDictionary -> unit
Public Overridable Sub Install (stateSaver As IDictionary)

Paramètres

stateSaver
IDictionary

IDictionary utilisé pour enregistrer les informations nécessaires à l'exécution d'une opération de validation, de restauration ou de désinstallation.

Exceptions

ArgumentException

Le paramètre stateSaver a la valeur null.

Exception

Une exception s'est produite dans le gestionnaire d'événements BeforeInstall d'un des programmes d'installation de la collection.

- ou -

Une exception s'est produite dans le gestionnaire d'événements AfterInstall d'un des programmes d'installation de la collection.

Exemples

L’exemple suivant illustre la Install méthode de la Installer classe . Une classe est dérivée de la Installer classe de base et la Install méthode est remplacée.

   // Override the 'Install' method of the Installer class.
public:
   virtual void Install( IDictionary^ mySavedState ) override
   {
      Installer::Install( mySavedState );
      // Code maybe written for installation of an application.
      Console::WriteLine( "The Install method of 'MyInstallerSample' has been called" );
   }

// Override the 'Install' method of the Installer class.
public override void Install( IDictionary mySavedState )
{
   base.Install( mySavedState );
   // Code maybe written for installation of an application.
   Console.WriteLine( "The Install method of 'MyInstallerSample' has been called" );
}

' Override the 'Install' method of the Installer class.
Public Overrides Sub Install(mySavedState As IDictionary)
   MyBase.Install(mySavedState)
   ' Code maybe written for installation of an application.
   Console.WriteLine("The Install method of 'MyInstallerSample' has been called")
End Sub

Notes pour les héritiers

  • Si vous remplacez la Install(IDictionary) méthode dans une classe dérivée, veillez à appeler d’abord la méthode de la classe de Install(IDictionary) base dans votre méthode dérivée. La Install(IDictionary) méthode appelle la Install(IDictionary) méthode de chaque programme d’installation contenue dans la Installers propriété de cette instance. Une fois les programmes d’installation autonomes exécutés, cette méthode met à jour l’objet IDictionary (spécifié par le stateSaver paramètre) pour refléter la status de l’installation. Le IDictionary doit être vide lorsqu’il est passé à la Install(IDictionary) méthode . Si toutes les Install(IDictionary) méthodes réussissent, la Commit(IDictionary) méthode est appelée. Sinon, la Rollback(IDictionary) méthode est appelée.

  • Si vous devez ajouter des instances de programme d’installation à la Installers collection dans la Install(IDictionary) méthode, veillez à effectuer les mêmes ajouts à la collection dans la Uninstall(IDictionary) méthode. Toutefois, vous pouvez éviter de conserver la collection dans les deux méthodes si vous ajoutez des instances de programme d’installation à la Installers collection dans le constructeur de classe pour votre programme d’installation personnalisé.

S’applique à

Voir aussi