构建页面,项目设计器(C#)

使用项目设计器“生成”页指定项目的生成配置属性。 此页面仅适用于 Visual C# 项目。

若要访问“生成”页,请在解决方案资源管理器中选择项目节点(而不是解决方案节点)。 然后选择菜单上的 “视图”和 “属性页 ”。 当项目设计器出现时,选择“ 生成 ”选项卡。

注释

您的计算机可能会显示本文中某些 Visual Studio 用户界面元素的不同名称或位置。 你可能使用的是不同版本的 Visual Studio 或不同的环境设置。 有关详细信息,请参阅 个性化 IDE

配置和平台

通过以下选项,可以选择要显示或修改的配置和平台。

注释

使用简化的生成配置,项目系统确定是生成调试版本还是发布版本。 因此,不会显示这些选项。 有关详细信息,请参阅 如何:设置调试和发布配置。

配置

指定要显示或修改的配置设置。 这些设置可以是 “活动”(调试)( 默认值)、 “调试”、“ 发布”或 “所有配置”。

平台

指定要显示或修改的平台设置。 默认设置为“活动”(任何 CPU)。 可以使用 Configuration Manager 更改活动平台。 有关详细信息,请参阅 “如何:创建和编辑配置”。

概况

通过以下选项可以配置多个 C# 编译器设置。

条件编译符号

指定要对其执行条件编译的符号。 用分号(“;”)分隔符号。 有关详细信息,请参阅 /define (C# 编译器选项)

定义 DEBUG 常量

将 DEBUG 定义为应用中所有源代码文件中的符号。 选择此选项等效于使用 /define:DEBUG 命令行选项。

定义 TRACE 常量

将 TRACE 定义为应用中所有源代码文件中的符号。 选择此选项等效于使用 /define:TRACE 命令行选项。

平台目标

指定要由输出文件面向的处理器。 为任何兼容 32 位 Intel 的处理器选择 x86,为任何 64 位 Intel 兼容处理器选择 x64,为 ARM 处理器选择 ARM,或选择 任何 CPU 来指定任何处理器是可接受的。 任何 CPU 都是项目的默认值,因为它允许应用程序在最广泛的硬件上运行。

有关详细信息,请参阅 /platform(C# 编译器选项)

可为空的

指定项目范围的 C# 可为 null 上下文。 Visual Studio 16.5 中引入了此 UI 选项,并且仅针对使用 C# 8.0 或更高版本的项目启用。

有关详细信息,请参阅 可为空上下文

首选 32 位

如果选择了 Prefer32 位 复选框,则应用程序在 32 位和 64 位版本的 Windows 上运行为 32 位应用程序。 如果清除了此复选框,则应用程序在 32 位版本的 Windows 上运行为 32 位应用程序,在 64 位版本的 Windows 上运行为 64 位应用程序。

如果将应用程序作为 64 位应用程序运行,指针大小会翻倍,并且兼容性问题可能会与独占 32 位的其他库一起发生。 仅当 64 位应用程序需要 4 GB 以上的内存或 64 位指令时,才能运行 64 位应用程序可提供显著的性能改进。

仅当以下所有条件均为 true 时,此复选框才可用:

  • “生成”页上平台目标 列表设置为 “任何 CPU”。

  • “应用程序”页上“输出类型 ”列表指定项目是应用程序。

  • 应用程序页上目标框架 列表指定 .NET Framework 4.5。

允许不安全的代码

允许使用 不安全 关键字编译的代码。 有关详细信息,请参阅 /unsafe (C# 编译器选项)

优化代码

启用或禁用编译器执行的优化,使输出文件更小、更快、更高效。 有关详细信息,请参阅 /optimize (C# 编译器选项)

错误和警告

以下设置用于为生成过程配置错误和警告选项。

警告级别

指定要为编译器警告显示的级别。 有关详细信息,请参阅 /warn(C# 编译器选项)

禁止显示警告

阻止编译器生成一个或多个警告的能力。 用逗号或分号分隔多个警告编号。 有关详细信息,请参阅 /nowarn(C# 编译器选项)

将警告视为错误

以下设置用于指定将哪些警告视为错误。 选择以下选项之一,以指示生成遇到警告时返回错误的情况。 有关详细信息,请参阅 /warnaserror(C# 编译器选项)

None - 不将任何警告视为错误。

All - 将所有警告视为错误。

特定警告 - 将指定的警告视为错误。 用逗号或分号分隔多个警告编号。

小窍门

如果不希望将代码分析警告视为错误,请参阅 代码分析常见问题解答

输出

以下设置用于配置生成过程的输出选项。

“输出路径”

指定此项目的配置的输出文件的位置。 在此框中输入生成输出的路径,或选择 “浏览”按钮来指定路径。 路径相对;如果输入绝对路径,它将保存为相对路径。 默认路径为 bin\Debug 或 bin\Release\。

使用简化的生成配置,项目系统确定是生成调试版本还是发布版本。 “生成” 命令将从 “调试”菜单(F5)将生成置于调试位置,而不考虑你指定的 输出 路径。 但是,“生成”菜单中的“生成” 命令将其置于指定的位置。 有关详细信息,请参阅 了解生成配置

XML 文档文件

指定将处理文档注释的文件的名称。 有关详细信息,请参阅 /doc(C# 编译器选项)

注册 COM 互作

指示托管应用程序将公开 COM 对象(COM 可调用包装器),该对象允许 COM 对象与托管应用程序交互。 必须将此应用程序的项目设计器的应用程序中的“输出类型”属性设置为“类库”,以便“注册 COM 互作”属性可用。 有关你可能包含在 Visual C# 应用程序中并公开为 COM 对象的示例类,请参阅 示例 COM 类

生成序列化程序集

指定编译器是否使用 XML 序列化程序生成器工具(Sgen.exe)创建 XML 序列化程序集。 如果已使用该类序列化代码中的类型,则序列化程序集可以提高启动性能 XmlSerializer 。 默认情况下,此选项设置为 “自动”,它指定仅当已用于 XmlSerializer 将代码中的类型编码为 XML 时,才会生成序列化程序集。 Off 指定从不生成序列化程序集,而不考虑代码是否使用 XmlSerializer启用 指定始终生成序列化程序集。 序列化程序集.XmlSerializers.dll命名 TypeName 。 有关详细信息,请参阅 XML 序列化程序生成器工具(Sgen.exe)。

高级

单击可显示“ 高级生成设置”对话框(C#) 对话框。

另请参阅