Procédure pas à pas : utilisation d'une action personnalisée pour afficher un message au cours de l'installation

  • Article

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.

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 une action personnalisée

  1. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

  2. 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

  1. 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.

  2. 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.

  3. Ajoutez la procédure suivante pour substituer les procédures Installer, Valider, Restaurer et Désinstaller 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 Sub

Public Overrides Sub Commit(ByVal savedState As System.Collections.IDictionary)
    MyBase.Commit(savedState)
End Sub

Public Overrides Sub Rollback(ByVal savedState As System.Collections.IDictionary)
    MyBase.Rollback(savedState)
End Sub

Public Overrides Sub Uninstall(ByVal savedState As System.Collections.IDictionary)
    MyBase.Uninstall(savedState)
End Sub

    public override void Install(System.Collections.IDictionary stateSaver)
{
    base.Install(stateSaver);
    string myInput = Context.Parameters["message"];
    if (myInput == null)
    {
        myInput = "There was no message specified";
    }
    MessageBox.Show(myInput);
}

public override void Commit(IDictionary savedState)
{
    base.Commit(savedState);
}

public override void Rollback(IDictionary savedState)
{
    base.Rollback(savedState);
}

public override void Uninstall(IDictionary savedState)
{
    base.Uninstall(savedState);
}

    Notes

    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.

  4. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code Class1, puis sélectionnez Supprimer (car il est inutile).

Pour créer un projet de déploiement

  1. Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.

  2. 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.

  3. Dans la fenêtre Propriétés, sélectionnez la propriété ProductName et tapez PassData.

    Sélectionnez également la propriété Manufacturer et tapez Mon entreprise.

  4. 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.

  5. Dans la boîte de dialogue Ajouter le groupe de sorties du projet, sélectionnez la sortie principale pour le projet PassData.

    Sortie principale de PassData (Actif) apparaît dans l'Éditeur du système de fichiers.

Pour ajouter une action personnalisée

  1. 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.

  2. 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.

  3. Dans la boîte de dialogue Sélectionner un élément dans le projet, double-cliquez sur Dossier d'application.

  4. Sélectionnez Sortie principale de PassData (Actif) pour ajouter l'action personnalisée PassData au nœud Installer.

  5. Dans la fenêtre Propriétés, sélectionnez la propriété CustomActionData, puis tapez /Message="[MESSAGE]".

  6. Assurez-vous que la propriété InstallerClass a la valeur True (valeur par défaut).

Pour personnaliser l'interface utilisateur de l'installation

  1. Sélectionnez le projet d'installation dans l'Explorateur de solutions. Dans le menu Affichage, pointez sur Éditeur, puis cliquez sur Interface utilisateur.

  2. Dans l'Éditeur muni d'une interface utilisateur, sélectionnez le nœud Début sous Installer. Dans le menu Action, cliquez sur Ajouter une boîte de dialogue.

  3. Dans la boîte de dialogue Ajouter une boîte de dialogue, sélectionnez la boîte de dialogue Zones de texte (A).

  4. 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.

  5. Dans la fenêtre Propriétés, sélectionnez la propriété BannerText et tapez :

    Quel est votre message ?

  6. Sélectionnez la propriété BodyText et tapez :

    Entrez votre message ici.

  7. Sélectionnez la propriété Edit1Label et tapez :

    Message :

  8. Sélectionnez la propriété Edit1Property et tapez :

    MESSAGE

  9. Sélectionnez les propriétés Edit2Visible, Edit3Visible et Edit4Visible, et affectez-leur la valeur False.

  10. 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!.

    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

  1. Dans l'Explorateur Windows, naviguez jusqu'à votre répertoire de projet et recherchez le programme d'installation généré. La configuration de projet par défaut est Debug ou Release.

  2. 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.

    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. Dans la boîte de dialogue d'installation Quel est votre message ?, tapez Hello World!.

    Notes

    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

  1. Dans le Panneau de configuration Windows, double-cliquez sur Ajout/Suppression de programmes ou Programmes et fonctionnalités.

  2. Sélectionnez Programme d'installation de PassData, cliquez sur Supprimer ou Désinstaller, 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.

Voir aussi

Référence

CustomActionData, propriété

Autres ressources

Gestion des actions personnalisées lors d'un déploiement