“项目设计器”->“生成”页 (C#)

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

要访问“生成”页,则在“解决方案资源管理器”中选择项目节点(不是“解决方案”节点)。 然后在菜单栏上依次选择**“项目”“属性”**。 项目设计器出现后,单击“生成”选项卡。

备注

以下说明中的某些 Visual Studio 用户界面元素在你计算机上的名称或显示位置可能有所不同。这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。有关详细信息,请参阅 在 Visual Studio 中自定义开发设置

配置和平台

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

备注

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

  • 配置
    指定要显示或修改的配置设置。 设置可以为**“活动(Debug)”(此为默认值)、“Debug”“Release”“所有配置”**。

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

常规

可以使用以下选项来配置几个 C# 编译器设置。

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

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

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

  • 目标 CPU
    指定输出文件面向的目标处理器。 为 32 位 Intel 兼容处理器选择 x86,为 64 位 Intel 兼容处理器选择 x64,为 ARM 处理器选择 ARM,或选择“任意 CPU”以表明可接受任何处理器。 “任何 CPU”是项目的默认值,因为它允许应用程序在最大硬件范围内运行。

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

  • “首选 32 位”
    如果选中“Prefer32-bit”复选框,则应用程序将在 Windows 32 位和 64 位版本中以 32 位应用程序运行。 如果已清除复选框,则应用程序将在 Windows 32 位版本中以 32 位应用程序和在 Windows 64 位版本中以 64 位应用程序运行。

    如果将应用程序当做 64 位应用程序运行,则指针大小会加倍,其他只有 32 位的库会发生兼容性问题。 仅当需要超过 4 GB 内存或 64 位指令时运行 64 位应用程序才有用,并可显著提高性能。

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

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

    • 在“应用程序页”中,“输出类型”列表指定该项是应用程序。

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

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

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

错误和警告

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

将警告视为错误

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


  • 不将任何警告视为错误。

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

  • 全部
    将所有警告视为错误。

Output

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

  • 输出路径
    指定该项目配置的输出文件的位置。 在此框中输入生成输出的路径,或选择“浏览”按钮来指定径。 注意,此路径是相对路径;如果输入绝对路径,它将保存为相对路径。 默认路径是 bin\Debug\ 或 bin\Release\。 有关详细信息,请参阅 调试和发布项目配置

    通过简化的生成配置,项目系统确定是生成调试版本还是发布版本。 **“调试”菜单上的“生成”命令 (F5) 会将生成版本放置在调试位置,而与指定的“输出路径”无关。 但是,“生成”菜单上的“生成”**会将生成版本放置在指定的位置。 有关详细信息,请参阅 调试和发布项目配置

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

  • 注册 COM 互操作
    指示托管应用程序将公开一个 COM 对象(可调用 COM 的包装器),以使 COM 对象可以与托管应用程序进行交互。 必须将此应用程序**“项目设计器”应用程序页中的“输出类型”属性设置为“类库”,才能使“为 COM 互操作注册”**属性可用。 有关可以包含在 Visual C# 应用程序中并公开为 COM 对象的示例类,请参见COM 类示例(C# 编程指南)

  • 生成序列化程序集
    指定编译器是否将使用 XML 序列化程序生成器工具 (Sgen.exe) 来创建 XML 序列化程序集。 序列化程序集可以提高 XmlSerializer 的启动性能,前提是您已使用该类对代码中的类型进行了序列化。 默认情况下,此选项被设置为**“自动”**,它指定该序列化程序集只能在您已经使用 XmlSerializer 将代码中的类型编码为 XML 才能生成。 **“关”**指定无论您的代码是否使用 XmlSerializer,该序列化程序集都将不会生成。 **“开”**指定通常都会生成该序列化程序集。 序列化程序集被命名为 TypeName.XmlSerializers.dll。 有关详细信息,请参阅 XML 序列化程序生成器工具 (Sgen.exe)

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

请参见

概念

项目属性引用

其他资源

C# 编译器选项