以下选项支持高级方案。 新的 MSBuild 语法以粗体显示。 旧的 csc.exe 语法以 code style 显示。

在 *.csproj 文件中的 元素中添加以下任一选项：

如果多个类包含 Main 方法，此选项将指定包含程序入口点的类。

或

其中 Program 是包含 Main 方法的类型。 提供的类名必须是完全限定类名；它必须包括完整命名空间（包含类），后跟类名。 例如，当 Main 方法位于 MyApplication.Core 命名空间中的 Program 类中时，编译器选项必须为 -main:MyApplication.Core.Program。 如果编译包含具有 Main 方法的多个类型，则可以指定哪个类型包含 Main 方法。

注意

此选项不能用于包含顶级语句的项目，即使该项目包含一个或多个 Main 方法也是如此。

PdbFile 编译器选项指定调试符号文件的名称和位置。 filename 值指定调试符号文件的名称和位置。

指定 DebugType 后，编译器将在创建输出文件（.exe 或 .dll）的相同目录中创建 .pdb 文件。 .pdb 文件与输出文件的名称具有相同的基文件名。 PdbFile 允许为 .pdb 文件指定非默认的文件名和位置。 此编译器选项不能在 Visual Studio 开发环境中进行设置，也不能以编程方式进行更改。

注意

指定 PathMap 将阻止断点在本地调试版本中工作。 仅为生产或持续集成生成设置 PathMap 。

PathMap 编译器选项指定如何将物理路径映射到编译器输出的源路径名称。 此选项将编译器在其上运行的计算机上的每个物理路径映射到应写入输出文件的相应路径。 在下面的示例中，path1 是当前环境中源文件的完整路径，sourcePath1 是任何输出文件中替代 path1 的源路径。 要指定多个映射的源路径，请用逗号分隔每个路径。

编译器将源路径写入其输出，原因如下：

ApplicationConfiguration 编译器选项使 C# 应用程序能够在程序集绑定时将程序集的应用程序配置 (app.config) 文件的位置指定为公共语言运行时 (CLR)。

其中 file 是包含程序集绑定设置的应用程序配置文件。 ApplicationConfiguration 的一种用途是处理高级方案，在这种方案中，程序集必须同时引用特定引用程序集的 .NET Framework 版本和 .NET Framework for Silverlight 版本。 例如，在 Windows Presentation Foundation (WPF) 中编写的 XAML 设计器可能需要为设计器用户界面引用 WPF 桌面以及随附于 Silverlight 的 WPF 子集。 同一设计器程序集必须访问这两个程序集。 默认情况下，单独引用会导致编译器错误，因为程序集绑定将这两个程序集视为等效。 借助 ApplicationConfiguration 编译器选项，可通过使用 标记指定禁用默认行为的 app.config 文件的位置，如以下示例所示。

编译器将文件的位置传递给 CLR 的程序集绑定逻辑。

注意

若要使用已在项目中设置的 app.config 文件，请将属性标记 添加到 .csproj 文件，并将其值设置为 true。 若要指定不同的 app.config 文件，请添加属性标记 并将其值设置为该文件的位置。

以下示例展示一个 app.config 文件，通过使用该文件，应用程序能够同时引用任何 .NET Framework 程序集（同时存在于后述两个实现中）的 .NET Framework 实现和 .NET Framework for Silverlight 实现。 ApplicationConfiguration 编译器选项指定此 app.config 文件的位置。

AdditionalLibPaths 选项指定通过 References 选项引用的程序集的位置。

其中 dir1 是在当前工作目录（从中调用编译器的目录）或公共语言运行时的系统目录中未找到引用程序集时，编译器将在其中进行查找的目录。 dir2 是要在其中搜索程序集引用的一个或多个其他目录。 用逗号分隔每个目录名称，且中间没有空格。 编译器按以下顺序搜索未完全限定的程序集引用：

使用 Reference 指定程序集引用。 AdditionalLibPaths 是累加的。 每一次指定的值都追加到以前的值中。 由于程序集清单中未指定依赖程序集的路径，因此应用程序将查找并使用全局程序集缓存中的程序集。 编译器可以引用程序集并不表示公共语言运行时可以在运行时找到并加载程序集。 有关运行时如何搜索引用的程序集的详细信息，请参阅运行时如何定位程序集。

GenerateFullPaths 选项导致编译器在列出编译错误和警告时指定文件的完整路径。

默认情况下，由编译所产生的错误和警告指定其中发现错误的文件的名称。 GenerateFullPaths 选项导致编译器指定文件的完整路径。 此编译器选项在 Visual Studio 中不可用，并且无法以编程方式进行更改。

通过使用 PreferredUILang 编译器选项，可指定 C# 编译器用于显示输出（如错误消息）的语言。

其中 language 是用于编译器输出的语言的语言名称。 可以使用 PreferredUILang 编译器选项指定 C# 编译器用于错误消息和其他命令行输出的语言。 如果未安装针对该语言的语言包，将改用操作系统的语言设置。

通过 BaseAddress 选项，可指定加载 DLL 的首选基址。 若要深入了解何时且为何要使用此选项，请参阅 Larry Osterman 的网络日志。

其中 address 是 DLL 的基址。 可将此地址指定为十进制数、十六进制数或八进制数。 DLL 的默认基址由 .NET 公共语言运行时设置。 此地址中的低序字将被舍入取整。 例如，如果指定 0x11110001，它将被舍入为 0x11110000。 要完成 DLL 的签名过程，请使用具有 -R 选项的 SN.EXE。

此选项控制用于对 PDB 中的源文件进行编码的校验和算法。

algorithm 必须是 SHA1（默认）或 SHA256。

如果所需页不是系统的当前默认代码页，则此选项指定编译期间要使用的代码页。

其中 id 是要用于编译中的所有源代码文件的代码页 ID。 编译器将首先尝试将所有源文件解释为 UTF-8。 如果源代码文件使用除 UTF-8 以外的编码并使用除 7 位 ASCII 字符以外的字符，请使用 CodePage 选项指定应使用的代码页。 CodePage 适用于编译中的所有源代码文件。 有关如何查找系统上支持哪些代码页的信息，请参阅 GetCPInfo。

Utf8Output 选项使用 UTF-8 编码显示编译器输出。

在某些国际配置中，编译器输出无法在控制台上正确显示。 使用 Utf8Output 并将编译器输出重定向到文件。

FileAlignment 选项用于指定输出文件中各节的大小。 有效值为 512、1024、2048、4096 和 8192。 这些值以字节为单位。

在 Visual Studio 中，可以从项目的“生成”属性的“高级”页中设置 FileAlignment 选项。 每一节都将在是 FileAlignment 值的倍数的边界上对齐。 没有固定的默认值。 如果未指定 FileAlignment，公共语言运行时在编译时会选取一个默认值。 通过指定节的大小，可以影响输出文件的大小。 修改节的大小可能对将在较小设备上运行的程序有用。 使用 DUMPBIN 可查看有关输出文件中各节的信息。

指示编译器输出每个错误结尾位置的行和列。

默认情况下，编译器会为所有错误和警告在源代码中写入起始位置。 当此选项设置为 true 时，编译器会为每个错误和警告写入起始和结尾位置。

NoStandardLib 可防止导入 mscorlib.dll，后者定义了整个 System 命名空间。

如果你想要定义或创建自己的 System 命名空间和对象，请使用此选项。 如果不指定 NoStandardLib，则 mscorlib.dll 将被导入到程序中（与指定 false 相同）。

指定可执行文件可以运行的子系统的最低版本。 大多数情况下，此选项确保该可执行文件可以使用早期 Windows 版本中未提供的安全功能。

注意

若要指定子系统本身，请使用 TargetType 编译器选项。

major.minor 指定所需的子系统最低版本，以主版本和次要版本之间使用点标记的方式表示。 例如，你可以指定应用程序不能在 Windows 7 之前的操作系统上运行。 将此选项的值设置为 6.01，如本文后面的表中所述。 将 major 和 minor 的值指定为整数。 minor 版本中的前导零不会更改版本，但尾随零会。 例如，6.1 和 6.01 表示相同的版本，但 6.10 表示另一个版本。 建议次要版本用两位数表示，以免混淆。

下表列出了常见的 Windows 子系统版本。

SubsystemVersion 编译器选项的默认值取决于以下列表中的条件：

指定所具有的非公共类型可供 .netmodule 访问的程序集的名称。

生成 .netmodule 时，应使用 ModuleAssemblyName 并满足以下条件：

有关生成 .netmodule 的详细信息，请参阅模块的 TargetType 选项。 有关友元程序集的详细信息，请参阅友元程序集。

启用或禁用有关在编译过程中找到的 System.Runtime.CompilerServices.InternalsVisibleToAttribute 的其他诊断信息：

如果元素内容为 true，则启用诊断；如果元素内容为 false 或不存在，则禁用诊断。

ReportIVTs 在启用时会报告以下信息：