Fichiers d'application, boîte de dialogue

Mise à jour : Juillet 2008

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.

La grille affiche les informations Nom de fichier, État de la publication et Groupe de téléchargement pour chaque fichier. À partir de Visual Studio 2008 SP1, une colonne Hachage apparaît également dans la grille.

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.

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.

À partir de Visual Studio 2008 SP1, vous pouvez choisir les fichiers à hacher. 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.

Remarque :

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 génération est alors générée. Pour plus d'informations, consultez Comment : signer des manifestes d'application et de déploiement.

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
Include	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
Exclude	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.

Voir aussi

Référence

Page Publier, Concepteur de projets

Historique des modifications

Date	Historique	Raison
Juillet 2008	Ajout d'une phrase sur la nouvelle colonne Hachage.	Modifications de fonctionnalités dans le SP1.
Juillet 2008	Ajout de précisions sur la description de l'option Inclure.	Commentaires client.
Juillet 2008	Ajout d'informations sur le hachage facultatif.	Modifications de fonctionnalités dans le SP1.