Procédure pas à pas : création d'une action personnalisée
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. Vous pouvez utiliser les actions personnalisées pour exécuter du code une fois l'installation terminée.
Notes
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.
Pour créer l'action personnalisée
Dans le menu Fichier, cliquez sur Nouveau projet.
Dans la boîte de dialogue Nouveau projet, cliquez sur Windows, puis sur Bibliothèque de classes. 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, puis cliquez 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) au fichier de code Installer1, sous le constructeur.
<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)> Public Overrides Sub Install(ByVal stateSaver As System.Collections.IDictionary) MyBase.Install(stateSaver) End Sub <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 <Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)> Public Overrides Sub Rollback(ByVal savedState As System.Collections.IDictionary) MyBase.Rollback(savedState) End Sub <Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)> Public Overrides Sub Uninstall(ByVal savedState As System.Collections.IDictionary) MyBase.Uninstall(savedState) End Sub[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)] public override void Install(IDictionary stateSaver) { base.Install(stateSaver); } [System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)] public override void Commit(IDictionary savedState) { base.Commit(savedState); System.Diagnostics.Process.Start("https://www.microsoft.com"); } [System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)] public override void Rollback(IDictionary savedState) { base.Rollback(savedState); } [System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)] public override void Uninstall(IDictionary savedState) { base.Uninstall(savedState); }Notes
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. Répétez l'opération pour les méthodes Install, Rollback et Uninstall.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code Class1, puis cliquez sur Supprimer (car il est inutile).
Pour ajouter 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, développez Projets de configuration et de déploiement, cliquez sur Programme d'installation de Visual Studio, puis 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.
Notes
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 de solutions, cliquez avec le bouton droit sur votre projet d'installation, puis cliquez sur Ouvrir le dossier dans l'Explorateur Windows.
Naviguez jusqu'à la sortie du projet et copiez les fichiers du programme d'installation d'actions personnalisées.msi, Setup.exe et tous les autres fichiers et sous-répertoires de ce répertoire sur un autre ordinateur.
Notes
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.
Notes
Vous devez avoir des autorisations d'installation sur l'ordinateur pour pouvoir exécuter le programme d'installation.
Notes
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.