解决与程序集引用相关的错误和警告

  • CS0012: 类型“类型名称”是在未被引用的程序集中定义的。必须添加对程序集“程序集名称”的引用。
  • CS0234: 命名空间“命名空间名称”中不存在类型或命名空间名称“类型或命名空间名称”(是否缺少程序集引用?)
  • CS0246: 找不到类型或命名空间名称“类型或命名空间名称”(缺少 using 指令或程序集引用吗?
  • CS0400: 无法在全局命名空间中找到类型或命名空间名称“类型或命名空间名称”(缺少程序集引用吗?
  • CS0731: 程序集“assembly name”中类型“type name”的类型转发器会导致循环
  • CS1068: 无法在全局命名空间中找到类型名称“type name”。此类型已转发到程序集“程序集名称”,请考虑添加对该程序集的引用。
  • CS1069: 在命名空间“namespace name”中找不到类型名称“type name”。此类型已转发到程序集“assembly name”。请考虑添加对该程序集的引用。
  • CS1070: 找不到类型名称“type name”。此类型已转发到程序集“程序集名称”。请考虑添加对该程序集的引用。
  • CS1509: 引用的文件“filename”不是程序集
  • CS1542: “filename”无法添加到此程序集,因为它已是程序集
  • CS1704: 已导入具有相同简单名称“程序集简单名称”的程序集。尝试删除其中一个引用(例如“reference”),或对其进行签名以并行启用。
  • CS1714: 无法解析或无效此类型的基类或接口。 (历史错误)。
  • CS1760: 程序集“第一个程序集引用”和“第二个程序集引用”引用相同的元数据,但只有一个是链接引用(使用 /link 选项指定);请考虑删除其中一个引用。
  • CS7008: 程序集名称“程序集名称”是保留的,不能用作交互式会话中的引用
  • CS7041: 每个链接的资源和模块必须具有唯一的文件名。在此程序集中多次指定文件名“filename”
  • CS7061: 在“netmodule name”中存在重复的“attribute name”特性
  • CS7068: 对类型“type name”的引用声称它是在此程序集中定义的,但它并未在源代码或任何添加的模块中定义
  • CS7069: 对类型“type name”的引用声明在“程序集名称”中定义,但找不到它
  • CS7071: 程序集引用 'assembly name' 无效,无法解析
  • CS7079: 类型“类型名称”是在尚未添加的模块中定义的。必须添加模块“模块名称”。
  • CS7086: 存储在“module filename”中的模块名称“module name”必须与其文件名匹配。
  • CS7087: 模块名称无效:原因
  • CS7098: 链接的 netmodule 元数据必须提供完整的 PE 图像:“引用显示名称”。
  • CS8004: 从模块“module name”导出的“type name”与此程序集的主模块中声明的类型冲突。
  • CS8005: 从模块“first module name”导出的“first type name”与从模块“second module name”导出的类型“second type name”冲突。
  • CS8006: 转发类型“type name”与此程序集的主模块中声明的类型冲突。
  • CS8007: 转发到程序集“first assembly name”的“first type name”与转发到程序集“second assembly name”的类型“second type name”冲突。
  • CS8008: 转发到程序集“程序集名称”的“转发类型名称”与从模块“模块名称”导出的类型名称冲突。
  • CS8014: 缺少对“module name” netmodule 的引用。
  • CS8015: 模块“module name”已在此程序集中定义。每个模块必须具有唯一的文件名。
  • CS8090: 引用的程序集“assembly name”中存在错误。
  • CS8203: 程序集名称无效:原因
  • CS8206: 程序集 'assembly name' 中的模块 'module name' 正将类型 'type name' 转发到多个程序集:'first assembly name' 和 'second assembly name'。
  • CS8356: 预定义类型“type name”在多个引用的程序集中声明:“first assembly name”和“second assembly name”
  • CS9286: “接收方类型”不包含“成员名称”的定义,且找不到适用于“接收方类型”接收器的可访问扩展成员“成员名称”(你缺少 using 指令或程序集引用吗?)

此外,本文还保留以下历史警告:

  • CS1683: 对类型“Type Name”的引用声称它是在此程序集中定义的,但它未在源文件或任何添加的模块中定义。(历史警告。)

缺少引用

  • CS0012: 类型“类型名称”在未引用的程序集中定义。必须添加对程序集“程序集名称”的引用。
  • CS0234: 类型或命名空间名称“类型或命名空间名称”在命名空间“命名空间名称”中不存在(是否缺少程序集引用?)
  • CS0246: 找不到类型或命名空间名称“类型或命名空间名称”(缺少 using 指令或程序集引用吗?
  • CS0400: 无法在全局命名空间中找到类型或命名空间名称“type or namespace name”(缺少程序集引用吗?)
  • CS1714: 无法解析或无效此类型的基类或接口。 (历史错误)。
  • CS9286: “接收方类型”不包含“成员名称”的定义,并且找不到适用于类型“接收方类型”的接收器的可访问扩展成员“成员名称”(是否缺少 using 指令或程序集引用?)

添加对定义所需类型的程序集的引用,包括被引用类型的依赖项(CS0012)。 检查类型的拼写、命名空间和辅助功能,并添加相应的 using 指令或限定名称(CS0234、 CS0246)。 指令 using 不添加程序集引用。

仅对位于该位置的名称使用 全局别名限定符 ;否则,请通过其实际命名空间(CS0400)限定类型。 提供类型,而不是持有 System.Type 的变量,因为 typeof 或 is 等运算符需要的是类型。

引用声明所需扩展成员并导入其命名空间的程序集;检查该成员是否适用于接收方类型(CS9286)。

CS1714 是没有当前 Roslyn 消息资源的历史错误。 当前 Roslyn 改用 CS0012;为较旧的编译器输出保留带引号的措辞。

如果应存在引用,请还原包含 dotnet restore 的包并检查不兼容的包或程序集版本(CS0012)。 在更改引用之前检查还原/生成警告。 对于过时的输出,请运行 dotnet clean 和 dotnet build。 如果包文件已损坏,请使用 dotnet nuget locals all --clear 清除本地缓存,然后还原。 如果已识别的包安装已损坏,请使用 dotnet remove package PackageName 和 dotnet add package PackageName 删除并重新安装该包。

类型转发

  • CS0731: 程序集“assembly name”中类型“type name”的类型转发器会导致循环
  • CS1068: 无法在全局命名空间中找到类型名称“type name”。此类型已转发到程序集“程序集名称”,请考虑添加对该程序集的引用。
  • CS1069: 命名空间“命名空间名称”中找不到类型名称“type name”。此类型已转发到程序集“程序集名称”,请考虑添加对该程序集的引用。
  • CS1070: 找不到类型名称“type name”。此类型已转发到程序集“程序集名称”。请考虑添加对该程序集的引用。
  • CS8006: 转发类型“type name”与此程序集的主模块中声明的类型冲突。
  • CS8007: 转发到程序集“first assembly name”的“first type name”与转发到程序集“second assembly name”的类型“second type name”冲突。
  • CS8008: 转发到程序集“assembly name”的类型“forwarded type name”与从模块“module name”导出的类型“exported type name”冲突。
  • CS8206: 程序集“assembly name”中的模块“module name”正将类型“type name”转发到多个程序集:“first assembly name”和“second assembly name”。

添加对程序集的引用,该程序集定义了由诊断标识的转发类型(CS1068、CS1069、CS1070)。

更正输出或其输入中的冲突转发元数据:

  • 选择输出是在本地定义类型还是将其转发到其他位置。 删除过时的转发器或本地定义,并重新生成受影响的源或模块(CS8006)。
  • 使相关转发器就同一个目标程序集达成一致。 删除或重新生成选择其他目标的模块或转发声明(CS8007)。
  • 在从添加的模块导出类型并将其转发到另一个程序集之间进行选择。 删除过时的转发器或冲突的模块定义,并重新生成输入(CS8008)。
  • 替换或重新生成引用的程序集或模块,该程序集或模块将同一类型转发到多个目标。 对齐依赖项版本或删除引入冲突元数据的引用(CS8206)。

CS8006 和 CS8008 是 仅在生成期间出现的诊断:这些冲突检查在发出期间运行,并且不会由 SemanticModel.GetDiagnostics 返回。 源别名会更改名称查找,而不会更改冲突的导出或转发元数据。

通过使链在定义该类型的程序集处结束来打破转发循环;不要将其转发回较早的程序集(CS0731)。 重新生成或替换受影响的依赖项。 源别名不会修复循环。

以下最小测试夹具需要 .NET Framework IL 汇编器(ilasm.exe)以及具有 .NET Framework 引用的 C# 编译器。 这不是通用的新式 SDK/运行时工作流。 将这些 IL 块保存为 Circular.il 和 Circular2.il:

.assembly extern mscorlib
{
  .publickeytoken = (B7 7A 5C 56 19 34 E0 89)
  .ver 4:0:0:0
}
.assembly extern Circular2 {}
.assembly Circular {}
.module Circular.dll
.class extern forwarder Circular.Referenced.TypeForwarder
{
  .assembly extern Circular2
}
.class public abstract sealed User extends [mscorlib]System.Object
{
  .method public static class [Circular2]Circular.Referenced.TypeForwarder F() cil managed
  {
    .maxstack 1
    newobj instance void [Circular2]Circular.Referenced.TypeForwarder::.ctor()
    ret
  }
}
.assembly extern Circular {}
.assembly Circular2 {}
.module Circular2.dll
.class extern forwarder Circular.Referenced.TypeForwarder
{
  .assembly extern Circular
}

将客户端另存为 CS0731.cs:

class Client
{
    static void Main()
    {
        User.F();
    }
}

使用可用的所需工具和引用,组装库并编译客户端:

ilasm /dll /output:Circular.dll Circular.il
ilasm /dll /output:Circular2.dll Circular2.il
csc /reference:Circular.dll /reference:Circular2.dll CS0731.cs

这两个程序集将同一类型转发给对方,因此客户端报告 CS0731。 若要更正 fixture,请用此定义替换 Circular2.il,然后重新运行相同的命令:

.assembly extern mscorlib
{
  .publickeytoken = (B7 7A 5C 56 19 34 E0 89)
  .ver 4:0:0:0
}
.assembly Circular2 {}
.module Circular2.dll
.class public auto ansi Circular.Referenced.TypeForwarder extends [mscorlib]System.Object
{
  .method public specialname rtspecialname instance void .ctor() cil managed
  {
    .maxstack 1
    ldarg.0
    call instance void [mscorlib]System.Object::.ctor()
    ret
  }
}

转发链现在以公共类型定义 Circular2.dll结尾。

重复引用

  • CS1704: 已导入具有相同简单名称“程序集简单名称”的程序集。尝试删除其中一个引用(例如“reference”),或对其进行签名以并行启用。
  • CS1760: 程序集“第一个程序集引用”和“第二个程序集引用”引用相同的元数据,但只有一个是链接引用(使用 /link 选项指定);请考虑删除其中一个引用。
  • CS7041: 每个链接的资源和模块必须具有唯一的文件名。在此程序集中多次指定文件名“filename”
  • CS7061: “netmodule name”中重复的“attribute name”属性
  • CS8004: 从模块“module name”导出的“type name”与此程序集的主模块中声明的类型冲突。
  • CS8005: 从模块“first module name”导出的“first type name”与从模块“second module name”导出的类型“second type name”冲突。
  • CS8015: 模块“模块名称”已在此程序集中定义。每个模块必须具有唯一的文件名。
  • CS8356: 预定义类型“type name”在多个引用的程序集中声明:“first assembly name”和“second assembly name”

删除冗余或不兼容的程序集引用,而不是添加同一依赖项的另一个副本(CS1704)。 检查具有相同简单名称的未签名程序集,以及引用多个不兼容版本的项目。 如果不同的签名标识是有意的,请一致地配置这些标识,而不是重命名文件来伪装重复标识。

选择对同一元数据的一个引用,并保持互操作嵌入设置一致(CS1760)。 此处 /link 表示具有嵌入互操作类型的程序集引用,而不是添加的 netmodule。

为每个链接资源和添加的模块提供唯一的文件名,或删除冗余输入(CS7041)。 不同的资源名称不能解决重复的链接资源文件名,链接资源也可以与模块文件名相冲突。 对于重复存储的模块名称,请删除重复的模块或重新生成具有唯一名称和匹配文件名的不同模块(CS8015):将副本移动到不同的目录不会更改其存储的名称。

解决添加的 netmodule(CS7061)携带的冲突程序集属性。 从源中删除意外重复项,或使用预期属性值重新生成参与模块。 对于不允许多次应用的属性,不同的构造函数或参数值可能会冲突;相同的应用会被去重。 使用允许多个应用程序的属性可以具有不同的值,并且已知程序集属性具有特殊处理,因此不要假定每个重复属性都是错误的。 请参阅 全局属性 和 属性规范。

在发出程序集之前更正冲突的类型定义:

  • 删除或重命名与添加的模块导出的公共类型冲突的主模块定义,或者重新生成该模块,而无需该冲突的定义(CS8004)。
  • 删除冗余模块,或重新构建这些输入项,以便两个模块不会导出冲突的类型标识(CS8005)。

CS8004 和 CS8005 是 仅限生成阶段的诊断:这些冲突检查在发出期间运行,并且不会由 SemanticModel.GetDiagnostics 返回。 更正定义或模块输入;源别名不会更改其发出的元数据标识。

使用一个一致的框架和引用程序集集,删除或替换定义相同预定义运行时类型(CS8356)的不兼容引用。 不要添加该类型的另一个源定义。

程序集引用无效

  • CS1509: 引用的文件“filename”不是程序集
  • CS1542: “filename”无法添加到此程序集,因为它已是程序集
  • CS1683:对类型“Type Name”的引用声称它是在此程序集中定义的,但它未在源代码或任何添加的模块中定义。(历史警告。)
  • CS7008: 程序集名称“程序集名称”是保留的,不能用作交互式会话中的引用
  • CS7068:对类型“type name”的引用声称它是在此程序集中定义的,但它未在源代码或任何添加的模块中定义
  • CS7069: 对类型“type name”的引用声明在“程序集名称”中定义,但找不到它
  • CS7071: 程序集引用“assembly name”无效,无法解析
  • CS7079: 类型“类型名称”是在尚未添加的模块中定义的。必须添加模块“模块名称”。
  • CS7086: 存储在“module filename”中的模块名称“module name”必须与其文件名匹配。
  • CS7087: 模块名称无效:原因
  • CS7098: 链接的 netmodule 元数据必须提供完整的 PE 图像:“引用显示名称”。
  • CS8014: 缺少对“module name”网络模块的引用。
  • CS8090: 引用的程序集“程序集名称”中存在错误。
  • CS8203: 程序集名称无效:原因

验证程序集引用和链接模块输入。 将输入类型与提供输入类型相匹配:

  • 通过 AddModules 提供 netmodule,而不是 引用。 对于直接编译器参数,请将 /reference:Input.netmodule 更改为 /addmodule:Input.netmodule(CS1509)。
  • 通过 引用提供程序集,而不是 AddModules。 将 /addmodule:Input.dll 更改为 /reference:Input.dll(CS1542)。

应根据输入是否包含程序集清单来选择,而不是根据其扩展名。 如果要生成模块而不是程序集,请使用 module 的 值重新生成。 使用支持 netmodule 的编译器工具链和目标;选择另一个输入选项不会将 netmodule 转换为单独可引用的程序集。

还原链接模块的原始文件名,或使用与预期文件名匹配的存储模块名称(CS7086)重新生成它。 重命名文件不会重写存储在其元数据中的名称。

设置 CSharpCompilationOptions.ModuleName时,请使用非空的简单文件名,不带前导空格、目录分隔符、冒号、NUL 字符或无效 Unicode(CS7087)。 提供模块名称,而不是路径;按照诊断中的原因操作。

添加定义所需类型的模块(CS7079)。 显式提供其他已添加模块所需的所有 netmodule,而不仅仅是模块依赖链(CS8014)中的第一个模块。 使所需文件的名称与引用它们的元数据保持一致。

对于 Roslyn API 输入,提供每个链接的 netmodule 的完整 PE 映像 ,而不仅仅是其元数据目录(CS7098)。 例如,使用 MetadataReference.CreateFromFile(path, MetadataReferenceProperties.Module) 或从带有完整映像的 ModuleMetadata.CreateFromImage 获取引用。 如果从流创建模块元数据,请保留对完整映像的访问权限; PEStreamOptions.PrefetchEntireImage 这样做,而 PrefetchMetadata 单独不这样做。 ModuleMetadata.CreateFromMetadata 仅提供元数据块,并且不足以用于链接的 netmodule。 文件名、别名或命令行选项无法还原缺少的 PE 数据。

对于已组装的多模块程序集,请通过 AssemblyMetadata 提供其组成模块,并将实际清单模块置于首位;不要用不相关的同名模块替代缺失的组成模块(CS7079)。 将 netmodule 包装在 AssemblyMetadata 中不会创建程序集清单。 在编译使用元数据对象和任何延迟读取流期间,使其保持活动状态,并在之后释放它们。

更正输入元数据中未解析的类型所有权:在声明属于当前程序集(CS7068)时在源或已添加模块中包含预期类型,或者替换或重新生成应定义它的引用程序集(CS7069)。 CS1683 是第一个案例的历史警告;当前 Roslyn 报告 CS7068。 该警告没有当前的 Roslyn 消息资源;其带引号的措辞保留为较旧的编译器输出。

为交互式会话引用(CS7008)选择非保留的程序集名称。 更正格式不正确的程序集标识(CS7071)或诊断中所述的输出程序集名称(CS8203)。 创建 Roslyn 编译时,提供有效的程序集名称而不是路径。 检查拼写和实际引用的文件,而不是仅更改源代码级别的别名。

读取所引用程序集报告的错误,然后重新生成或替换该依赖项(CS8090)。 添加另一个引用不会更正依赖项中已存在的错误。