选择 .netmodule 输入文件的格式

  • 项目

MSIL .obj 文件（用 /clr 编译）也可用作 .netmodule 文件。 .obj 文件包含元数据和本机符号。 .netmodule 只包含元数据。

可以通过 /addmodule 编译器选项将 MSIL .obj 文件传递到任何其他 Visual Studio 编译器（但请注意，.obj 文件将属于生成的程序集，并且必须随程序集一起提供）。 例如，Visual C# 和 Visual Basic 具有 /addmodule 编译器选项。

注意

大多数情况下，您需要从创建 .net 模块的编译中向链接器传递 .obj 文件。 将 .dll 或 .netmodule MSIL 模块文件传递到链接器可能导致 LNK1107。

通过源中的 #include 引用的 .obj 文件及其关联的 .h 文件允许 C++ 应用程序使用模块中的本机类型，而在 .netmodule 文件中，只有托管类型可由 C++ 应用程序使用。 如果尝试将 .obj 文件传递给 #using，则有关本机类型的信息将不可用；#包括 .obj文件的 .h 文件。

其他 Visual Studio 编译器只能使用模块中的托管类型。

请使用以下内容确定是否需要使用 .netmodule 或 .obj 文件作为 MSVC 链接器的模块输入：

  • 如果您要使用 Visual C++ 之外的 Visual Studio 编译器进行构建，请生成 .netmodule 并使用它作为链接器的输入。

  • 如果要使用 MSVC 编译器生成模块，并且该模块将用于构建库以外的内容，则使用编译器生成的 .obj 文件作为链接器的模块输入；不要使用 .netmodule 文件作为输入。

  • 如果模块将用于生成本机（而不是托管）库，请使用 .obj 文件作为链接器模块输入并生成 .lib 库文件。

  • 如果模块将用于构建托管库，并且链接器的所有模块输入都是可验证的（使用 /clr:safe 生成），则使用 .obj 文件作为链接器的模块输入并生成 .dll（程序集）或 .netmodule（模块）库文件。

  • 如果模块将用于生成托管库，并且链接器的一个或多个模块输入都仅使用 /clr 生成，则使用 .obj 文件作为链接器的模块输入并生成 .dll（程序集）。 如果要从库公开托管类型，并且还希望 C++ 应用程序使用库中的本机类型，则库将包含库组件模块的 .obj 文件（你还需要为每个模块提供 .h 文件，以便可以使用#从源代码中包括来引用它们）。

另请参阅

用作链接器输入的 .netmodule 文件