通过

“应用程序文件”对话框

更新： 2008 年 7 月

使用此对话框，可以指定项目中的文件如何根据发布、动态下载和更新进行分类。它包含一个网格，该网格列出默认情况下未排除或具有一个下载组的项目文件。

该网格显示每个文件的“文件名”、“发布状态”和“下载组”。从 Visual Studio 2008 SP1 开始，“哈希”列也出现在网格中。

文件的“发布状态”确定在发布、更新和动态下载期间将如何处理该文件。每个“发布状态”选项的意义在下表中进行说明。请注意，只有适用于特定文件类型的“发布状态”选项才会显示在该类型的文件的“发布状态”下拉列表中。

若要访问此对话框，请在“解决方案资源管理器”中选择项目节点，然后在“项目”菜单上单击“属性”。当“项目设计器”出现时，单击“发布”选项卡。在“发布”页上，单击“应用程序文件”按钮。

从 Visual Studio 2008 SP1 开始，可以选择要散列的文件。此对话框包含一个“哈希”列，该列提供要将文件包含在生成的哈希中或从生成的哈希中排除文件的选项。

说明：

如果将文件的“哈希”设置设置为“排除”，则会在网格中该文件的记录中显示一条警告。即使在“签名”页上不选择“为 ClickOnce 清单签名”选项，也会显示警告“无法签名包含非散列引用的项目”。如果您打算将应用程序与未签名的清单一起发布，则可以安全忽略此警告。如果将应用程序配置为与签名的清单一起发布，将引发生成错误。有关更多信息，请参见如何：对应用程序和部署清单进行签名。

发布状态选项

说明

此选项适用的文件类型

数据文件

将数据文件包括在清单中，并在执行发布命令时将其复制到发布位置。

“生成操作”设置为“内容”的任何非程序集文件都会有此发布状态。默认情况下，带有 .mdf、.ldf 和 .xml 扩展名的文件都被设置为“数据文件”。

将此类型的文件安装到数据目录。当对应用程序进行更新时，应用程序可能会迁移数据文件。

当对应用程序进行更新时，会将此文件中的信息迁移到应用程序的下一个版本中。

非程序集文件

包括

将文件包括在清单中，并在执行发布命令时将其复制到发布位置。此类型的文件将安装到程序文件文件夹，应用程序的可执行文件 (.exe) 和程序集驻留在该文件夹。

所有文件

排除

将文件排除在清单外，并在执行发布命令时不将其复制到发布位置。

所有文件

系统必备

将文件包括在清单中，并在执行发布命令时不将其复制到发布位置。如果在 GAC（全局程序集缓存）中没有此文件，将阻止安装。此系统必备由最终用户安装。

仅强名称签名的程序集应标记为系统必备。

程序集文件

对于数据文件，此迁移不会覆盖用户在客户端计算机上的更改。有关如何迁移数据库文件的更多信息，请参见 在 ClickOnce 应用程序中访问本地数据和远程数据。

如果在“发布状态”中选择了一个“（自动）”选项（例如“包括（自动）”），则基于以下规则来自动确定文件的“发布状态”：

  • 默认情况下排除 .pdb 文件。

  • 默认情况下 .mdf、.ldf、.mdb 和 .xml 文件被设置为“数据文件”。

  • 默认情况下排除 <程序集名称>.xml 文件。

  • “生成操作”设置为“内容”的所有其他内容文件都具有默认值“包括”。“生成操作”的设置不等于“内容”的任何内容文件不会在“应用程序文件”对话框中显示，而且不会发布。

“包括”和“排除”重写自动决定“（自动）”选项。

请参见

参考

“项目设计器”->“发布”页

修订记录

日期

修订历史记录

原因

2008 年 7 月

增加了有关新的“哈希”列的句子。

SP1 功能更改。

2008 年 7 月

增加了对“包括”选项的说明的阐述。

客户反馈。

2008 年 7 月

增加了有关可选哈希的信息。

SP1 功能更改。