Comment : spécifier les fichiers publiés via ClickOnce
Lors de la publication d'une application ClickOnce, tous les fichiers du projet qui ne contiennent pas de code sont déployés avec l'application. Il peut arriver que vous ne souhaitiez ou ne deviez pas publier certains fichiers, ou que vous souhaitiez installer certains fichiers selon des conditions définies. Visual Studio fournit des fonctions permettant d'exclure des fichiers, de marquer des fichiers comme fichiers de données ou composants requis, et de 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 à partir de la page Publier du Concepteur de projets.
Initialement, il n'existe qu'un seul groupe de fichiers appelé (Requis). Vous pouvez créer des groupes de fichiers supplémentaires et leur assigner des fichiers. Vous ne pouvez pas changer le Groupe de téléchargement des fichiers nécessaires à l'exécution de l'application. Par exemple, le fichier .exe de l'application ou les fichiers marqués comme des fichiers de données doivent appartenir au groupe (Requis).
La valeur d'état de publication par défaut d'un fichier est balisée avec (Auto). Par exemple, le fichier .exe de l'application possède un état de publication de Inclure (Auto) par défaut.
Les fichiers dont la propriété Action de génération a la valeur Contenu sont désignés comme fichiers d'application et seront marqués comme inclus par défaut. Ils peuvent être inclus, exclus, ou marqué comme fichiers de données. Les exceptions sont les suivantes :
Les fichiers de données tels que les fichiers de base de données SQL (.mdf et .mdb) et les fichiers XML sont marqués par défaut comme fichiers de données.
Les références aux assemblys (fichiers .dll) sont désignées comme suit lorsque vous ajoutez la référence : si Copie locale a la valeur False, l'assembly est marqué par défaut comme assembly requis (Condition préalable (Auto)) devant être présent dans le GAC (Global Assembly Cache) avant que l'application ne soit installée. Si Copie locale a la valeur True, l'assembly est marqué par défaut comme assembly d'application (Inclure (Auto)) et copié dans le dossier d'application à l'installation. Une référence COM s'affichera dans la boîte de dialogue Fichiers d'application (comme un fichier .ocx) uniquement si sa propriété Isolé a la valeur True. 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, affectez à la propriété Action de génération la valeur Contenu.
Pour exclure des fichiers de la publication ClickOnce
Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 exclure.
Dans le champ État de la publication, sélectionnez Exclure dans la liste déroulante.
Pour marquer des fichiers comme fichiers de données
Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 comme fichier de données.
Dans le champ État de la publication, sélectionnez Fichier de données dans la liste déroulante.
Pour marquer des fichiers comme composants requis
Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 comme composant requis. Notez que votre application doit posséder une référence à l'assembly d'application pour figurer dans la liste.
Dans le champ État de la publication, sélectionnez Composant requis dans la liste déroulante.
Pour ajouter un nouveau groupe de fichiers
Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 un fichier que vous souhaitez inclure dans le nouveau groupe.
Notes
La propriété Action de génération des fichiers doit avoir la valeur Contenu avant que les noms de fichiers s'affichent 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
Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet 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 un 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 changer le Groupe de téléchargement des fichiers nécessaires à l'exécution de l'application.
Voir aussi
Tâches
Comment : publier une application ClickOnce à l'aide de l'Assistant Publication