Procédure pas à pas : utilisation d'une action personnalisée pour afficher un message au cours de l'installation
Mise à jour : novembre 2007
La procédure pas à pas suivante montre comment utiliser une action personnalisée pour prendre l'entrée d'utilisateur et la passer à un message qui apparaît pendant l'installation. C'est une démonstration simple d'actions personnalisées qui sont utiles pour beaucoup d'autres tâches. Par exemple, une action personnalisée pourrait prendre comme entrée d'utilisateur l'emplacement du fichier Setup.exe et l'utiliser pour lancer l'application après l'avoir installée.
Cette procédure pas à pas décrit le passage de données à une propriété dynamique à l'aide d'une action personnalisée et explique comment utiliser une classe Installer et la propriété CustomActionData.
.gif "Remarque") Remarque : |
|---|
Selon vos paramètres actifs ou votre édition, les boîtes de dialogue et les commandes de menu que vous voyez peuvent différer de celles qui sont décrites dans l'aide. Pour modifier vos paramètres, cliquez sur Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio. |
| Remarque : |
|---|
Les instructions suivantes décrivent comment créer un projet de déploiement à l'aide d'un projet Visual Basic ; les principes généraux s'appliquent à tous les projets dans un langage de Visual Studio qui prennent en charge le déploiement des applications Windows. |
Pour créer une action personnalisée
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Fichier.
Dans la boîte de dialogue Nouveau projet, sélectionnez Visual Basic dans le volet Types de projets, puis choisissez Bibliothèque de classes dans le volet Modèles. Dans la zone Nom, tapez PassData.
Le projet est ajouté à l'Explorateur de solutions.
Pour créer une classe Installer
Dans le menu Projet, cliquez sur Ajouter une classe.
Dans la boîte de dialogue Ajouter un nouvel élément, choisissez Classe Installer. Acceptez le nom par défaut.
Lorsque la classe Installer apparaît sur l'aire de conception, cliquez avec le bouton droit sur cette aire, puis cliquez sur Afficher le code pour consulter le contenu du fichier dans l'éditeur de code.
Ajoutez la procédure suivante pour substituer la procédure Install de la classe de base :
Public Overrides Sub Install(ByVal stateSaver As System.Collections.IDictionary) MyBase.Install(stateSaver) Dim myInput As String = Me.Context.Parameters.Item("Message") If myInput Is Nothing Then myInput = "There was no message specified" End If MsgBox(myInput) End SubRemarque :Si vous tapez Public Overrides, suivi d'un espace, Intellisense fournira une liste de méthodes et de propriétés ; vous pouvez alors sélectionner Installer dans la liste et obtenir la déclaration complète.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Class1.vb et sélectionnez Supprimer (parce que cet élément est inutile).
Pour créer un projet de déploiement
Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.
Dans la boîte de dialogue Ajouter un nouveau projet, développez le nœud Autres types de projets dans le volet Type de projet et sélectionnez Configuration et déploiement, puis cliquez sur Projet d'installation dans le volet Modèles. Dans la zone Nom, tapez Programme d'installation de PassData.
Dans la fenêtre Propriétés, sélectionnez la propriété ProductName et tapez PassData.
Ensuite, sélectionnez la propriété Manufacturer et tapez Ma société.
Dans l'Éditeur du système de fichiers, sélectionnez le nœud Dossier d'application. Dans le menu Action, pointez sur Ajouter, puis cliquez sur Sortie de projet.
Dans la boîte de dialogue Ajouter le groupe de sorties du projet, sélectionnez la sortie principale pour le projet PassData.
Sortie principale dePassData (Actif) apparaît dans l'Éditeur du système de fichiers.
Pour ajouter une action personnalisée
Sélectionnez le projet Programme d'installation de PassData dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur et cliquez sur Actions personnalisées.
Dans l'Éditeur des actions personnalisées, sélectionnez le nœud Installer (niveau supérieur). Dans le menu Action, cliquez sur Ajouter une action personnalisée.
Dans la boîte de dialogue Sélectionner un élément dans le projet, double-cliquez sur Dossier d'application.
Sélectionnez Sortie principale de PassData (Actif). L'action personnalisée PassData sera alors ajoutée au nœud Installer.
Dans la fenêtre Propriétés, sélectionnez la propriété CustomActionData, puis tapez /Message="[MESSAGE]".
Assurez-vous que la propriété InstallerClass a la valeur True (valeur par défaut).
Pour personnaliser l'interface utilisateur de l'installation
Sélectionnez le projet d'installation dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur, puis cliquez sur Interface utilisateur.
Dans l'Éditeur de l'interface utilisateur, sélectionnez le nœud Début sous Installer. Dans le menu Action, cliquez sur Ajouter une boîte de dialogue.
Dans la boîte de dialogue Ajouter une boîte de dialogue, sélectionnez la boîte de dialogue Zones de texte (A).
Dans le menu Action, cliquez sur Monter. Répétez l'opération jusqu'à ce que la boîte de dialogue Zones de texte (A) se trouve au-dessus du nœud Dossier d'installation.
Dans la fenêtre Propriétés, sélectionnez la propriété BannerText et tapez :
Quel est votre message ?
Sélectionnez la propriété BodyText et tapez :
Entrez votre message ici.
Sélectionnez la propriété Edit1Label et tapez :
Message :
Sélectionnez la propriété Edit1Property et tapez :
MESSAGE
Sélectionnez les propriétés Edit2Visible, Edit3Visible et Edit4Visible, et affectez-leur la valeur False.
Dans le menu Générer, cliquez sur Générer Programme d'installation de PassData**.**
Pour effectuer l'installation sur votre ordinateur de développement
Sélectionnez le projet Programme d'installation de PassData dans l'Explorateur de solutions. Dans le menu Projet, cliquez sur Installer.
Cette action exécute le programme d'installation sur votre ordinateur de développement. Dans la boîte de dialogue d'installation Quel est votre message ?, tapez Hello World!.
Remarque :Vous devez avoir des autorisations d'installation sur l'ordinateur pour pouvoir exécuter le programme d'installation.
Pour effectuer le déploiement vers un autre ordinateur
Dans l'Explorateur Windows, naviguez jusqu'à votre répertoire de projet et recherchez le programme d'installation généré. Le chemin d'accès par défaut est \Documents and Settings\VotreNomDeConnexionMes Documents\Visual Studio 2005\Projects\Nom du dossier de solution\Programme d'installation de mon Bloc-notes\configuration de projet\Programme d'installation de mon Bloc-notes.msi. La configuration de projet par défaut est Debug ou Release.
Copiez les fichiers Programme d'installation de PassData.msi et Setup.exe, ainsi que tous les autres fichiers et sous-répertoires du répertoire sur un autre ordinateur.
Remarque :Pour effectuer l'installation sur un ordinateur ne se trouvant pas sur un réseau, copiez les fichiers sur des médias traditionnels, tels que des CD-ROM.
Sur l'ordinateur cible, double-cliquez sur le fichier Setup.exe pour exécuter le programme d'installation. Dans la boîte de dialogue d'installation Quel est votre message ?, tapez Hello World!.
Remarque :Vous devez avoir des autorisations d'installation sur l'ordinateur pour pouvoir exécuter le programme d'installation.
Pour tester l'installation
- Exécutez l'application et vérifiez que la zone de texte contient le texte 'Hello World!' entré au cours de l'installation.
Pour désinstaller l'application
Dans le Panneau de configuration Windows, double-cliquez sur Ajout/Suppression de programmes.
Dans la boîte de dialogue Ajouter ou supprimer des programmes, sélectionnez Programme d'installation de PassData, cliquez sur Supprimer, puis sur OK pour fermer la boîte de dialogue.
Conseil :Pour désinstaller l'application de votre ordinateur de développement, dans le menu Projet, cliquez sur Désinstaller.