Spécifier les fichiers publiés par ClickOnce
Au moment de publier une application ClickOnce, tous les fichiers du projet qui ne correspondent pas à du code sont déployés avec l’application. Dans certains cas, vous pouvez juger que certains fichiers n’ont pas besoin d’être publiés ou décider de les installer en fonction de conditions. Visual Studio offre la possibilité d’exclure des fichiers, de marquer des fichiers en tant que fichiers de données ou prérequis, et créer des groupes de fichiers pour une installation conditionnelle.
Les fichiers d’une application ClickOnce sont gérés dans la boîte de dialogue Fichiers d’application, accessible depuis la page Publication du Concepteur de projet.
Au départ, il n’y qu’un seul groupe de fichiers nommé (Obligatoire). Vous pouvez créer des groupes de fichiers supplémentaires et leur attribuer des fichiers. Vous ne pouvez pas modifier le Groupe de téléchargement pour les fichiers indispensables à l’exécution de l’application. Par exemple, le fichier .exe de l’application ou les fichiers marqués en tant que fichiers de données doivent appartenir au groupe (Obligatoire).
La valeur d’état de publication par défaut d’un fichier est étiquetée (Auto). Par exemple, l’état de publication par défaut du fichier .exe de l’application est Inclure (Auto).
Les fichiers dont la propriété Action de build est définie sur Contenu sont désignés fichiers d’application et sont marqués comme étant inclus par défaut. Ils peuvent être inclus, exclus ou marqués en tant que fichiers de données. Les exceptions sont les suivantes :
Par défaut, les fichiers de données que sont les fichiers SQL Database (.mdf et .mdb) et les fichiers XML sont marqués en tant que fichiers de données.
Voici comment les références aux assemblys (fichiers .dll) sont désignées quand vous les ajoutez : si Copie locale a la valeur Faux, elles sont marquées par défaut en tant qu’assemblys obligatoires (Prérequis (Auto)) qui doivent être présents dans le GAC avant l’installation de l’application. Si Copie locale a la valeur Vrai, l’assembly est marqué par défaut comme étant un assembly d’application (Inclure (Auto)) et est copié dans le dossier d’application au moment de l’installation. Une référence COM n’apparaît dans la boîte de dialogue Fichiers d’application (en tant que fichier .ocx) que si sa propriété Isolé est définie sur Vrai. Par défaut, elle est incluse.
Pour ajouter des fichiers à la boîte de dialogue Fichiers d’application
Sélectionnez un fichier de données dans l’Explorateur de solutions.
Dans la fenêtre Propriétés, modifiez la propriété Action de build en lui attribuant la valeur Contenu.
Pour exclure des fichiers de la publication ClickOnce
Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.
Cliquez sur l'onglet Publier.
Notes
Dans ClickOnce pour .NET Core 3.1 et .NET 5 ou version ultérieure, vous définissez les propriétés de déploiement à l’aide de l’outil Publication au lieu de l’Assistant Publication et de la page Publication du Concepteur de projet. Pour plus d’informations, consultez Déployer une application Windows .NET avec ClickOnce et ClickOnce pour .NET.
Cliquez sur le bouton Fichiers d’application pour ouvrir la boîte de dialogue Fichiers d’application.
Dans la boîte de dialogue Fichiers d’application, sélectionnez le fichier que vous souhaitez exclure.
Dans le champ État de publication, sélectionnez Exclure dans la liste déroulante.
Pour marquer des fichiers en tant que fichiers de données
Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.
Cliquez sur l'onglet Publier.
Cliquez sur le bouton Fichiers d’application pour ouvrir la boîte de dialogue Fichiers d’application.
Dans la boîte de dialogue Fichiers d’application, sélectionnez le fichier que vous souhaitez marquer en tant que données.
Dans le champ État de publication, sélectionnez Fichier de données dans la liste déroulante.
Pour marquer des fichiers en tant que prérequis
Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.
Cliquez sur l'onglet Publier.
Cliquez sur le bouton Fichiers d’application pour ouvrir la boîte de dialogue Fichiers d’application.
Dans la boîte de dialogue Fichiers d’application, sélectionnez l’assembly d’application (fichier .dll) que vous souhaitez marquer en tant que prérequis. Notez que votre application doit comporter une référence à l’assembly d’application pour que celui apparaisse dans la liste.
Dans le champ État de publication, sélectionnez Prérequis dans la liste déroulante.
Pour ajouter un nouveau groupe de fichiers
Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.
Cliquez sur l'onglet Publier.
Cliquez sur le bouton Fichiers d’application pour ouvrir la boîte de dialogue Fichiers d’application.
Dans la boîte de dialogue Fichiers d’application, sélectionnez le champ Groupe pour le fichier que vous souhaitez inclure dans le nouveau groupe.
Notes
La propriété Action de build du fichier doit être définie sur Contenu pour que son nom apparaisse dans la boîte de dialogue Fichiers d’application.
Dans le champ Groupe de téléchargement, sélectionnez <Nouveau...> dans la liste déroulante.
Dans la boîte de dialogue Nouveau groupe, attribuez un nom au groupe, puis cliquez sur OK.
Pour ajouter un fichier à un groupe
Après avoir sélectionné un projet dans l’ Explorateur de solutions, dans le menu Projet , cliquez sur Propriétés.
Cliquez sur l'onglet Publier.
Cliquez sur le bouton Fichiers d’application pour ouvrir la boîte de dialogue Fichiers d’application.
Dans la boîte de dialogue Fichiers d’application, sélectionnez le champ Groupe pour le fichier que vous souhaitez inclure dans le nouveau groupe.
Dans le champ Groupe de téléchargement, sélectionnez un groupe dans la liste déroulante.
Notes
Vous ne pouvez pas modifier le Groupe de téléchargement pour les fichiers indispensables à l’exécution de l’application.
Contenu connexe
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour