Procédure pas à pas : création d'une action personnalisée
Mise à jour : novembre 2007
La procédure pas à pas suivante décrit le processus de création d'une action personnalisée DLL permettant de diriger un utilisateur vers une page Web à la fin d'une installation.
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 utilisent un projet Visual Basic comme exemple pour indiquer comment créer un déploiement. 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 l'action personnalisée
Dans le menu Fichier, cliquez sur Nouveau projet.
Dans la boîte de dialogue Nouveau projet, sélectionnez Projets Visual Basic dans le volet Types de projets, puis cliquez sur Bibliothèque de classes dans le volet Modèles. Dans la zone Nom, tapez OpenWeb.
Le projet est ajouté à l'Explorateur de solutions.
Dans le menu Projet, cliquez sur Ajouter une classe, puis dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Classe Installer. Acceptez le nom par défaut : Installer1.vb. Cliquez sur Ajouter.
Basculez en mode Code en cliquant sur cliquez ici pour passer en mode code dans l'aire de conception (ou en cliquant avec le bouton droit sur l'aire de conception, puis en cliquant sur Afficher le code).
Dans l'éditeur de code, ajoutez le code suivant (lequel ouvre un navigateur Web) à Installer1.vb au-dessous du constructeur :
<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)> _ Public Overrides Sub Commit(ByVal savedState As _ System.Collections.IDictionary) MyBase.Commit(savedState) System.Diagnostics.Process.Start("https://www.microsoft.com") End Sub
Remarque : Si vous tapez Public Overrides, puis tapez un espace, IntelliSense fournira une liste de méthodes et de propriétés ; vous pouvez alors sélectionner Valider dans la liste et obtenir la déclaration complète.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Class1.vb, puis cliquez sur Supprimer (parce que cet élément est inutile).
Pour ajouter un projet de déploiement
Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.
Dans le volet Type de projet de la boîte de dialogue Ajouter un nouveau projet, ouvrez le nœud Autres types de projets et sélectionnez Projets de configuration et de déploiement. Dans le volet Modèles, cliquez sur Projet d'installation. Dans la zone Nom, tapez Pgm d'installation d'actions personnalisées.
Le projet est ajouté à l'Explorateur de solutions et l'Éditeur du système de fichiers s'ouvre.
Dans l'Éditeur du système de fichiers, sélectionnez Dossier d'application dans le volet gauche. Dans le menu Action, pointez sur Ajouter, puis cliquez sur Sortie du projet.
Dans la boîte de dialogue Ajouter le groupe de sorties du projet, OpenWeb s'affiche dans la liste Projet. Sélectionnez Sortie principale.
Sortie principale de OpenWeb (Actif) apparaît dans le Dossier d'application.
Pour ajouter l'action personnalisée
Sélectionnez le projet Pgm d'installation d'actions personnalisées dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur et cliquez sur Actions personnalisées.
L'Éditeur des actions personnalisées s'affiche.
Dans l'Éditeur des actions personnalisées, sélectionnez le nœud Valider. 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 OpenWeb (Actif).
Sortie principale de OpenWeb (Actif) apparaît sous le nœud Valider dans l'Éditeur des actions personnalisées.
Dans la fenêtre Propriétés, assurez-vous que la propriété InstallerClass a la valeur True (valeur par défaut).
Dans l'Éditeur des actions personnalisées, sélectionnez le nœud Installer et ajoutez Sortie principale d'OpenWeb à ce nœud, comme vous l'avez fait pour le nœud Valider.
Dans le menu Générer, cliquez sur Générer Pgm d'installation d'actions personnalisées.
Pour effectuer l'installation sur votre ordinateur de développement
Sélectionnez le projet Pgm d'installation d'actions personnalisées dans l'Explorateur de solutions. Dans le menu Projet, cliquez sur Installer.
Cette action exécute le programme d'installation et installe Pgm d'installation d'actions personnalisées sur votre ordinateur de développement. À la fin de l'installation, Internet Explorer doit être lancé et ouvrir le site Web Microsoft.com.
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\votre_nom_de_connexion\Mes documents\Visual Studio\Projects\Pgm d'installation d'actions personnalisées\Pgm d'installation d'actions personnalisées\configuration du projet\Pgm d'installation d'actions personnalisées.msi. La configuration de projet par défaut est Debug.
Copiez les fichiers Pgm d'installation d'actions personnalisées.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.
À la fin de l'installation, Internet Explorer doit être lancé et ouvrir le site Web Microsoft.com.
Remarque : Vous devez avoir des autorisations d'installation sur l'ordinateur pour pouvoir exécuter le programme d'installation.
Remarque : Si le .NET Framework n'est pas déjà installé sur l'ordinateur cible, ce déploiement l'installera ; ce processus peut durer plusieurs minutes.
Pour désinstaller l'application
Dans le Panneau de configuration, double-cliquez sur Ajout/Suppression de programmes.
Dans la boîte de dialogue Ajouter ou supprimer des programmes, sélectionnez Pgm d'installation d'actions personnalisées, puis cliquez sur Supprimer.
Conseil : Pour désinstaller l'application de votre ordinateur de développement : le projet Pgm d'installation d'actions personnalisées étant ouvert et sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet sur Désinstaller.