Comment : substituer les méthodes par défaut des composants d'installation
Mise à jour : novembre 2007
Par défaut, chaque composant d'installation possède les méthodes suivantes :
Install – Toutes les fonctions d'installation que le programme d'installation doit effectuer sont exécutées au sein de cette méthode. La classe Installer1 (ou toute classe RunInstallerAttribute ayant la valeur true) appelle Install sur chacun des composants d'installation qu'il contient, puis appelle Commit (si les installations sont toutes réussies) ou Rollback (si une erreur s'est produite).
Commit – Commit est appelé après que la méthode Install s'est déroulée avec succès sur tous les composants d'installation que contient la classe Installer. À ce stade, toutes les installations sont validées. Généralement, aucun traitement n'est effectué dans la méthode Commit pour éviter le déclenchement d'exceptions.
Rollback – La méthode Rollback est utilisée pour annuler l'installation précédente au cas où une erreur se serait produite au sein du processus d'installation. Si l'un des composants d'installation contenus dans la classe Installer déclenche une erreur, toutes les installations effectuées jusque-là sont annulées.
Uninstall – Uninstall permet de supprimer du système les ressources du composant d'installation. À l'inverse de l'installation, la désinstallation n'est pas transactionnelle. Si un processus de désinstallation échoue, le système continue d'essayer de désinstaller toutes les autres ressources.
Chacune de ces méthodes contient le traitement par défaut qui effectuera le travail requis sans modification. Cependant, si vous le souhaitez, vous pouvez substituer et modifier le traitement de chaque étape. Par exemple, pour un composant d'installation ServiceBase, vous pouvez modifier le traitement par défaut qui a lieu dans la procédure Commit de sorte que le processus d'installation démarre le service une fois que son installation s'est déroulée avec succès. Vous pouvez également modifier la procédure Uninstall de sorte que chaque service soit interrompu avant d'être désinstallé.
Pour substituer les valeurs par défaut d'un composant d'installation
Après avoir ajouté un composant d'installation à votre solution, ouvrez la classe Installer.
Recherchez le composant d'installation que vous souhaitez modifier et ouvrez-le dans l'éditeur de code.
Substituez la méthode appropriée et ajoutez la fonctionnalité de votre choix. Pour plus d'informations, consultez Substitution de propriétés et de méthodes.
.gif "Conseil")
Conseil :Assurez-vous de conserver le traitement d'origine nécessaire pour installer, valider, annuler ou désinstaller vos ressources quand vous substituez des méthodes dans la classe Installer1. En général, ajoutez du code aux fonctionnalités existantes plutôt que de supprimer une fonctionnalité existante.
Voir aussi
Tâches
Comment : ajouter des composants d'installation à vos projets
Comment : configurer des composants d'installation
Procédure pas à pas : installation d'un composant EventLog