诊断 Windows 运行时组件错误条件

本文提供了有关用托管代码编写的 Windows 运行时组件所受限制的附加信息。 它对来自 Winmdexp.exe（Windows 运行时元数据导出工具）的错误消息所提供的信息进行了扩展，对用 C# 和 Visual Basic 创建 Windows 运行时组件中提供的限制信息进行了补充。

本文并未涵盖所有错误。 此处讨论的错误按常规类别分组，并且每个类别包括一个由关联的错误消息组成的表。 搜索消息文本（省略占位符的特定值）或消息编号。 如果在此处找不到所需信息，请使用本文末尾的反馈按钮帮助我们改进文档。 包括错误消息。 也可以在 Microsoft Connect 网站提交 Bug。

本文包含以下几个部分：

• 当实现异步模式时，错误消息提供不正确的类型

• 缺少对 mscorlib.dll 和/或 System.Runtime.dll 的引用

• 不允许运算符重载

• 类的构造函数具有相同数量的参数

• 必须为具有相同数量参数的重载指定默认值

• 命名空间错误和输出文件的名称无效

• 导出不是有效的 Windows 运行时类型的类型

• 包含禁用类型的字段的结构

• 对于成员签名中数组的限制

• 数组参数必须指定数组内容是否可读或可写

• 具有名为“value”的参数的成员

实现异步接口的错误消息提供不正确的类型

托管 Windows 运行时 组件无法实现 Windows 运行时 表示异步操作（IAsyncAction、 IAsyncActionWithProgress<TProgress>、 IAsyncOperation<TResult>，或 IAsyncOperationWithProgress<TResult, TProgress>）的接口。 相反，.NET Framework 提供 AsyncInfo 类，用以在 Windows 运行时 组件中生成异步操作。 当您尝试实现一个按以前的名称 AsyncInfoFactory 不正确地引用该类的异步接口时显示的 Winmdexp.exe 错误消息。 .NET Framework 不再包括 AsyncInfoFactory 类。

缺少对 mscorlib.dll 或 System.Runtime.dll 的引用

仅当从命令行使用 Winmdexp.exe 时，才会出现此问题。 建议使用 /reference 选项来包括对 .NET Framework 核心引用程序集中的 mscorlib.dll 和 System.Runtime.dll 的引用，这些程序集位于“%ProgramFiles(x86)%\Reference Assemblies\Microsoft\Framework\.NETCore\v4.5”（32 位计算机上则为“%ProgramFiles%\...”）中。

不允许运算符重载

在用托管代码编写的 Windows 运行时组件中，不能在公共类型中公开重载运算符。

类的构造函数具有相同数量的参数

在 Windows 运行时中，一个类只能有一个构造函数，而该构造函数只能有给定数量的参数；例如，不能让一个构造函数具有单个类型为 String 的参数，而让另一个构造函数具有单个类型为 int（在 Visual Basic 中为 Integer）的参数。 唯一的解决方法是让每个构造函数使用不同数量的参数。

必须为具有相同数量参数的重载指定默认值

在 Windows 运行时中，仅当将某一重载指定为默认重载时，重载方法才可以具有相同数量的参数。 请参见用 C# 和 Visual Basic 创建 Windows 运行时组件中的“重载方法”。

命名空间错误和输出文件的名称无效

在 Windows 运行时中，Windows 元数据 (.winmd) 文件中的所有公共类型必须在一个共享 .winmd 文件名的命名空间中，或在该文件名的子命名空间中。 例如，如果 Visual Studio 2012 项目命名为 A.B（即 Windows 运行时组件为 A.B.winmd），则可包含公共类 A.B.Class1 和 A.B.C.Class2，但不可包含 A.Class3 (WME0006) 或 D.Class4 (WME1044)。

对于 A.Class3，可将 Class3 移至另一个命名空间或将 Windows 运行时组件的名称更改为 A.winmd。 虽然 WME0006 是警告，应将其视为错误。 在前面的示例中，调用 A.B.winmd 的代码将无法查找 A.Class3。

对于 D.Class4，任何文件名都不能同时包含 D.Class4 和 A.B 命名空间中的类，因此无法更改 Windows 运行时组件的名称。 可将 D.Class4 移至其他命名空间，或将其放入其他 Windows 运行时组件。

文件系统无法区分大小写，因此不允许使用按大小写区分的命名空间 (WME1067)。

你的组件必须至少包含一个 public sealed 类型（在 Visual Basic 中为 Public NotInheritable）。 否则，将收到 WME1042 或 WME1043，具体取决于组件是否包含私有类型。

Windows 运行时组件中的类型不能与命名空间同名 (WME1068)。

导出不是有效的 Windows 运行时类型的类型

组件的公共接口必须只公开 Windows 运行时类型。 但是，.NET framework 可为在 .NET framework 和 Windows 运行时中略有不同的许多常用类型提供映射。 这使得 .NET Framework 开发人员可以使用熟悉的类型，而不是学习新类型。 可在组件的公共接口中使用这些映射的 .NET Framework 类型。 请参见用 C# 和 Visual Basic 创建 Windows 运行时组件和 Windows 运行时类型的 .NET Framework 映射中的“在 Windows 运行时组件中声明类型”和“将 Windows 运行时类型传递给托管代码”。

其中许多映射都是接口。 例如，IList<T> 映射到 Windows 运行时 接口 IVector<T>。 如果使用 List<string>（在 Visual Basic 中为 List(Of String)）而不是 IList<string> 作为参数类型，Winmdexp.exe 将提供替代项的列表，其中包括 List<T> 所实现的所有映射接口。 如果使用嵌套的泛型类型，如 List<Dictionary<int, string>>（在 Visual Basic 中为 List(Of Dictionary(Of Integer, String))），Winmdexp.exe 将针对每个嵌套级别提供选择。 这些列表可能变得相当长。

通常，最佳选择是最接近类型的接口。 例如，对于 Dictionary<int, string>，最佳选择最可能是 IDictionary<int, string>。

错误号	消息正文
WME1033	方法“{0}”具有类型为“{2}”的参数“{1}”。“{2}”是无效的 Windows 运行时参数类型。
WME1038	方法“{0}”的签名中具有“{1}”类型的参数。虽然此类型不是有效的 Windows 运行时类型，但它可实现属于有效 Windows 运行时类型的接口。请考虑更改方法签名，以改用以下类型之一：“{2}”。
WME1039	方法“{0}”的签名中具有“{1}”类型的参数。 尽管此泛型类型是无效的 Windows 运行时类型，但此类型或其泛型参数实现了作为有效 Windows 运行时类型的接口。{2} 说明 对于 {2}，Winmdexp.exe 会附加一个替代项列表，例如“考虑将方法签名中的类型‘System.Collections.Generic.List<T>’更改为以下类型之一：‘System.Collections.Generic.IList<T>、System.Collections.Generic.IReadOnlyList<T>、System.Collections.Generic.IEnumerable<T>’。”
WME1040	方法“{0}”的签名中具有“{1}”类型的参数。请使用 Windows.Foundation.IAsyncAction、Windows.Foundation.IAsyncOperation 或其他 Windows 运行时异步接口之一，而不是使用托管任务类型。 标准 .NET 等待模式也适用于这些接口。有关将托管任务对象转换为 Windows 运行时异步接口的详细信息，请参见 System.Runtime.InteropServices.WindowsRuntime.AsyncInfo。

包含禁用类型的字段的结构

在 Windows 运行时中，结构只能包含字段，并且只有结构可以包含字段。 这些字段必须是公共的。 有效字段类型包括枚举、结构和基元类型。

对于成员签名中数组的限制

在 Windows 运行时中，成员签名中的数组必须是下限为 0（零）的一维数组。 不允许使用嵌套数组类型，如 myArray[][]（在 Visual Basic 中为 myArray()()）。

数组参数必须指定数组内容是否可读或可写

在 Windows 运行时中，参数必须为只读或只写。 不能将参数标记为 ref（在 Visual Basic 中为没有 OutAttribute 特性的 ByRef）。 这适用于数组内容，因此数组参数必须指示数组内容是只读的还是只写的。 out 参数的方向很清晰（在 Visual Basic 中为具有 OutAttribute 特性的 ByRef 参数），但必须标记按值传递的数组参数（在 Visual Basic 中为 ByVal）。 请参见向 Windows 运行时组件传递数组。

具有名为“value”的参数的成员

在 Windows 运行时 中，将返回值视为输出参数，并且这些参数的名称必须是唯一的。 默认情况下，Winmdexp.exe 为返回值指定名称“value”。 如果您的方法有一个名为“value”的参数，则会出现错误 WME1092。 可通过两种方式更正这种情况：

• 为参数给定“value”之外的名称（在属性访问器中，给定“returnValue”之外的名称）。

• 使用 ReturnValueNameAttribute 特性更改返回值的名称，如下所示：

  using System.Runtime.InteropServices;
  using System.Runtime.InteropServices.WindowsRuntime;
  
  [return: ReturnValueName("average")]
  public int GetAverage(out int lowValue, out int highValue)
  

  Imports System.Runtime.InteropServices
  Imports System.Runtime.InteropServices.WindowsRuntime
  
  Public Function GetAverage(<Out> ByRef lowValue As Integer, _
  <Out> ByRef highValue As Integer) As <ReturnValueName("average")> String
  

  备注

  如果更改返回值的名称，并且新名称与另一个参数的名称冲突，则会出现错误 WME1091。

JavaScript 代码可以按名称访问方法的输出参数，包括返回值。 有关示例，请参见 ReturnValueNameAttribute 特性。

错误号	消息正文
WME1091	方法“{0}”具有名为“{1}”的返回值，该名称与参数名称相同。 Windows 运行时方法参数和返回值必须具有唯一的名称。
WME1092	方法“{0}”具有名为“{1}”的参数，它与默认返回值名称相同。 请考虑为该参数使用其他名称或者使用 System.Runtime.InteropServices.WindowsRuntime.ReturnValueNameAttribute 来显式指定返回值的名称。 说明 对于属性访问器而言，默认名称为“returnValue”；对于所有其他方法，默认名称为“value”。

请参见

参考

Winmdexp.exe（Windows 运行时元数据导出工具）

概念

用 C# 和 Visual Basic 创建 Windows 运行时组件