指定资源的 C# 编译器选项

项目
05/09/2023

以下选项控制 C# 编译器如何创建或导入 Win32 资源。新的 MSBuild 语法以粗体显示。旧的 csc.exe 语法以 code style 显示。

Win32Resource / -win32res：指定 Win32 资源文件 (.res)。
Win32Icon / -win32icon：引用来自一个或多个指定程序集文件的元数据。
Win32Manifest / -win32manifest：指定 Win32 清单文件 (.xml)。
NoWin32Manifest / -nowin32manifest：不包括默认的 Win32 清单。
Resources / -resource：嵌入指定的资源（简短形式：/res）。
LinkResources / -linkresources：将指定的资源链接到此程序集。

Win32Resource

Win32Resource 选项会在输出文件中插入 Win32 资源。

<Win32Resource>filename</Win32Resource>

filename 是要添加到输出文件的资源文件。 Win32 资源可以包含版本或位图（图标）信息，这些信息有助于在文件资源管理器中标识您的应用程序。如果不指定此选项，编译器将根据程序集版本生成版本信息。

Win32Icon

Win32Icon 选项在输出文件中插入 .ico 文件，为输出文件提供在文件资源管理器中所需的外观。

<Win32Icon>filename</Win32Icon>

filename 是要添加到输出文件的 .ico 文件。可以使用资源编译器创建 .ico 文件。在编译 Visual C++ 程序时会调用资源编译器；.ico 文件是从 .rc 文件创建的。

Win32Manifest

使用 Win32Manifest 选项可以指定要嵌入到项目的可移植可执行 (PE) 文件中的用户定义的 Win32 应用程序清单文件。

<Win32Manifest>filename</Win32Manifest>

filename 是自定义清单文件的名称和位置。默认情况下，C# 编译器嵌入可指定“asInvoker”的请求执行级别的应用程序清单。它在生成该可执行文件的同一文件夹中创建清单。如果要提供自定义清单（例如，指定“highestAvailable”或“requireAdministrator”的请求执行级别的清单），请使用此选项指定文件名。

注意

此选项和 Win32Resources 选项是互斥的。如果尝试在同一命令行中同时使用这两个选项，将收到一个生成错误。

如果应用程序没有用于指定请求执行级别的应用程序清单，将受到 Windows 中“用户帐户控制”功能下的文件和注册表虚拟化的影响。有关详细信息，请参阅用户帐户控制。

如果满足下列任一条件，则应用程序会受到虚拟化的影响：

使用 NoWin32Manifest 选项，并且在随后的生成步骤中未提供清单，或者没有通过使用 Win32Resource 选项将其包含在 Windows 资源 (.res) 文件中。
提供的自定义清单未指定请求执行级别。

Visual Studio 创建默认 .manifest 文件，并将它与可执行文件一起存储在“调试”和“发布”目录中。可以用任意文本编辑器创建一个清单，然后将该文件添加到项目中，从而添加自定义清单。或者，也可以右键单击“解决方案资源管理器”中的“项目”图标，选择“添加新项”，然后选择“应用程序清单文件”。添加完新的或现有清单文件后，该文件将显示在“清单”下拉列表中。有关详细信息，请参阅“项目设计器”->“应用程序”页 (C#)。

提供应用程序清单的操作可以作为自定义生成后步骤，也可以通过使用 NoWin32Manifest 选项作为 Win32 资源文件的组成部分。如果希望应用程序受到 Windows Vista 的文件或注册表虚拟化的影响，请使用该选项。

NoWin32Manifest

使用 NoWin32Manifest 选项可指示编译器不将任何应用程序清单嵌入到可执行文件中。

<NoWin32Manifest />

使用此选项时，除非在 Win32 资源文件或以后的生成步骤中提供应用程序清单，否则应用程序会受到 Windows Vista 上虚拟化的影响。

在 Visual Studio 的“应用程序属性”页中，通过在“清单”下拉列表中选择“创建不带清单的应用程序”选项来设置此选项。有关详细信息，请参阅“项目设计器”->“应用程序”页 (C#)。

资源

将指定资源嵌入输出文件。

<Resources Include=filename>
  <LogicalName>identifier</LogicalName>
  <Access>accessibility-modifier</Access>
</Resources>

filename 是要嵌入到输出文件的 .NET 资源文件。 identifier（可选）是资源的逻辑名称；用于加载资源的名称。默认值是文件的名称。 accessibility-modifier（可选）是资源的可访问性：public 或 private。默认值为 public。默认情况下，如果使用 C# 编译器创建资源，则这些资源在程序集中是公有的。若要使资源变为私有，请将 private 指定为可访问性修饰符。不允许使用 public 或 private 以外的任何其他可访问性。例如，如果 filename 是由 Resgen.exe 创建的或在开发环境中创建的 .NET 资源文件，则可使用 System.Resources 命名空间中的成员来访问它。有关详细信息，请参阅 System.Resources.ResourceManager。对于所有其他资源，请使用 Assembly 类中的 GetManifestResource 方法在运行时访问资源。输出文件中资源的顺序由项目文件中所指定的顺序决定。

LinkResources

在输出文件中创建指向 .NET 资源的链接。不会在输出文件中添加资源文件。 LinkResources 不同于会在输出文件中嵌入资源文件的 Resource 选项。

<LinkResources Include=filename>
  <LogicalName>identifier</LogicalName>
  <Access>accessibility-modifier</Access>
</LinkResources>

filename 是要从程序集链接到的 .NET 资源文件。 identifier（可选）是资源的逻辑名称；用于加载资源的名称。默认值是文件的名称。 accessibility-modifier（可选）是资源的可访问性：public 或 private。默认值为 public。默认情况下，如果使用 C# 编译器创建链接资源，则这些资源在程序集中是公有的。若要使资源变为私有，请将 private 指定为可访问性修饰符。不允许使用 public 或 private 以外的任何其他修饰符。例如，如果 filename 是由 Resgen.exe 创建的或在开发环境中创建的 .NET 资源文件，则可使用 System.Resources 命名空间中的成员来访问它。有关详细信息，请参阅 System.Resources.ResourceManager。对于所有其他资源，请使用 Assembly 类中的 GetManifestResource 方法在运行时访问资源。 filename 中指定的文件可为任何格式。例如，你可能希望生成程序集的本机 DLL 部分，从而可将它安装到全局程序集缓存中，并且可从该程序集中的托管代码访问它。可在程序集链接器中执行相同的操作。有关详细信息，请参阅 Al.exe（程序集链接器）和使用程序集和全局程序集缓存。