Fichiers d'application, boîte de dialogue
Cette boîte de dialogue vous permet de catégoriser les fichiers de votre projet pour la publication, le téléchargement dynamique et la mise à jour. Elle contient une grille qui répertorie les fichiers projet qui ne sont pas exclus par défaut, ou qui ont un groupe de téléchargement.
Pour accéder à cette boîte de dialogue, sélectionnez un nœud de projet dans l'Explorateur de solutions, puis cliquez sur Propriétés dans le menu Projet. Lorsque le Concepteur de projets apparaît, cliquez l'onglet Publier. Sur la page Publier, cliquez sur le bouton Fichiers d'application.
La grille affiche les informations Nom de fichier, État de la publication, Groupe de téléchargement et Code de hachage pour chaque fichier.
L'État de la publication d'un fichier détermine la façon dont il sera traité pendant la publication, la mise à jour et le téléchargement dynamique. L'importance de chaque option État de la publication est affichée dans le tableau suivant. Remarquez que seules les options État de la publication qui s'appliquent à un type de fichier particulier sont affichées dans la liste déroulante État de la publication pour un fichier de ce type.
Option État de la publication |
Description |
Types de fichier auxquels cette option s'applique |
|---|---|---|
Fichier de données |
Incluez le fichier de données dans le manifeste et copiez-le à l'emplacement de publication lorsque la commande de publication est exécutée. Tout fichier non-assembly, pour lequel Action de génération a la valeur Contenu, peut avoir cet état de publication. Les fichiers avec les extensions .mdf, .ldf et .xml ont la valeur Fichier de données par défaut. Les fichiers de ce type seront installés dans le répertoire de données. Lors d'une mise à jour de l'application, un fichier de données peut être migré par l'application. En cas de mise à jour de l'application, migrez les informations contenues dans ce fichier à la nouvelle version de l'application. |
Fichiers non-assembly |
Inclure |
Incluez le fichier dans le manifeste et copiez-le à l'emplacement de publication lorsque la commande de publication est exécutée. Les fichiers de ce type seront installés dans le dossier Program Files, où les assemblys et les fichiers exécutables (.exe) de l'application résident. |
Tous les fichiers |
Exclure |
Excluez le fichier du manifeste et ne le copiez pas à l'emplacement de publication lorsque la commande de publication est exécutée. |
Tous les fichiers |
Condition préalable |
Incluez le fichier dans le manifeste et ne le copiez pas à l'emplacement de publication lorsque la commande de publication est exécutée. Bloquez l'installation si ce fichier n'est pas déjà présent dans le GAC (Global Assembly Cache). C'est à l'utilisateur final qu'il revient d'installer la condition préalable. Seuls les assemblys signés avec nom fort doivent être marqués comme conditions préalables. |
Fichiers d'assembly |
Pour les fichiers de données, la migration ne remplace pas les modifications d'utilisateur sur l'ordinateur client. Pour plus d'informations sur la migration des fichiers de base de données, consultez Accès aux données locales et distantes dans les applications ClickOnce.
Si vous sélectionnez l'une des options (Auto) dans l'État de la publication, telles que Include (Auto), l'État de la publication du fichier est déterminé automatiquement selon les règles suivantes :
Les fichiers .pdb sont exclus par défaut.
Les fichiers .mdf, .ldf, .mdb et .xml ont la valeur Fichier de données par défaut.
Le fichier <nom_assembly>.xml est exclu par défaut.
Tous les autres fichiers de contenu pour lesquels Action de génération a la valeur Contenu ont la valeur Include par défaut. Les fichiers de contenu pour lesquels Action de génération n'a pas la valeur Contenu ne sont pas affichés dans la boîte de dialogue Fichiers d'application et ne sont pas publiés.
Include et Exclude substituent les options déterminées (Auto) automatiquement.
Cette boîte de dialogue comporte une colonne Hachage avec une option permettant d'inclure les fichiers dans le hachage généré ou de les en exclure.
Notes
Si vous définissez le paramètre Hachage d'un fichier sur Exclure, un avertissement s'affiche dans l'enregistrement de ce fichier dans la grille. L'avertissement « Un projet qui contient des références non hachées ne peut pas être signé. » s'affiche, même si l'option Signer les manifestes ClickOnce n'est pas sélectionnée dans la page Signature. Si vous projetez de publier l'application avec des manifestes non signés, vous pouvez ignorer cet avertissement sans risque. Si l'application est configurée pour effectuer des publications avec des manifestes signés, une erreur de build est alors générée. Pour plus d'informations, consultez Comment : signer des manifestes d'application et de déploiement.