Windows ランタイム コンポーネントのエラー条件の診断

この技術情報では、マネージ コードで記述した Windows ランタイム コンポーネントの制限に関する追加情報を提供します。 Winmdexp.exe (Windows ランタイム メタデータのエクスポート ツール) からのエラー メッセージで提供される情報をさらに詳細に説明し、C++ および Visual Basic での Windows ランタイム コンポーネントの作成 で提供される制約の情報を補足します。

この技術情報はすべてのエラーについて説明しているわけではありません。 ここで説明するエラーは一般カテゴリにグループ化され、各カテゴリには関連付けられたエラー メッセージの表が含まれます。 メッセージ テキスト (プレースホルダーの特定の値を省略) またはメッセージ番号を検索してください。 必要な情報がない場合、この技術情報の末尾にあるフィードバック ボタンを使用してドキュメントの改善にご協力ください。 エラー メッセージを含めます。 また、Microsoft Connect Web サイトでバグを報告できます。

この記事は次のセクションで構成されています。

• 非同期パターンを実装したときのエラー メッセージで示される型が正しくない

• mscorlib.dll や System.Runtime.dll への参照が指定されていない

• 演算子のオーバーロードが許可されていない

• クラスのコンストラクターに同じ数のパラメーターがある

• 同じ数のパラメーターを持つオーバーロードには既定値を指定する必要がある

• 出力ファイルの名前空間のエラーと無効な名前

• 無効な Windows ランタイム型である型をエクスポートする

• 使用できない型のフィールドを含む構造体

• メンバー シグニチャ内の配列の制限

• 配列パラメーターは配列コンテンツが読み取り可能または書き込み可能かどうかを指定する必要がある

• "value" という名前のパラメーターを持つメンバー

非同期インターフェイスの実装に関するエラー メッセージで示される型が正しくない

マネージ Windows ランタイム コンポーネントは、非同期アクションまたは非同期操作を表す Windows ランタイム インターフェイスを実装できません (IAsyncAction、IAsyncActionWithProgress<TProgress>、IAsyncOperation<TResult>、または IAsyncOperationWithProgress<TResult, TProgress>)。 代わりに、.NET Framework には、Windows ランタイム コンポーネントの非同期操作を生成するための AsyncInfo クラスが用意されています。 非同期インターフェイスを実装しようとしたときに Winmdexp.exe により表示されるエラー メッセージでは、このクラスが誤って以前の名前の AsyncInfoFactory として示されます。 .NET Framework の AsyncInfoFactory クラスは廃止されています。

mscorlib.dll または System.Runtime.dll への参照が指定されていない

この問題は、コマンド ラインから Winmdexp.exe を使用する場合にのみ発生します。 .NET Framework のコア参照アセンブリから mscorlib.dll および System.Runtime.dll の両方への参照を含めるために /reference オプションを使用することをお勧めします。コア参照アセンブリは、「"%ProgramFiles(x86)%\Reference Assemblies\Microsoft\Framework\.NETCore\v4.5」(32 ビット コンピューターの場合は「%ProgramFiles%\...」) にあります。

演算子のオーバーロードが許可されていない

マネージ コードで記述された Windows ランタイム コンポーネントでは、パブリック型のオーバーロードされた演算子を公開することはできません。

クラスのコンストラクターに同じ数のパラメーターがある

Windows ランタイム クラスでは、指定された数のパラメーターを持つコンストラクターは 1 つしか許されません。たとえば、String 型の単一のパラメーターを持つコンストラクターと int (Visual Basic の Integer) 型の単一のパラメーターを持つコンストラクターを両方持つことはできません。 唯一の回避策は、各コンストラクターで異なる数のパラメーターを使用することです。

同じ数のパラメーターを持つオーバーロードには既定値を指定する必要がある

Windows ランタイム では、オーバーロードされたメソッドの 1 つが既定のオーバーロードとして指定されている場合にのみ、同じ数のパラメーターを持つことができます。 「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)。

コンポーネントには、少なくとも 1 つの 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 ランタイム コンポーネントの作成」および「.NET Framework での Windows ランタイム型の対応付け」にある「Windows ランタイム コンポーネントの宣言型」および「Windows ランタイム 型のマネージ コードへの引き渡し」を参照してください。

これらのマッピングの多くはインターフェイスです。 たとえば、IList<T> は Windows ランタイム インターフェイス IVector<T> にマップします。 パラメーター型として IList<string> の代わりに List<string> (Visual Basic の List(Of 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 await パターンもこれらのインターフェイスに適用されます。管理されているタスク オブジェクトを Windows ランタイム の非同期インターフェイスに変換する方法の詳細については、System.Runtime.InteropServices.WindowsRuntime.AsyncInfo を参照してください。

使用できない型のフィールドを含む構造体

Windows ランタイム では、構造体にはフィールドしか含めることができず、フィールドは構造体にのみ含めることができます。 これらのフィールドはパブリックである必要があります。 有効なフィールド型には、列挙体、構造体、およびプリミティブ型が含まれます。

メンバー シグニチャ内の配列の制限

Windows ランタイム では、メンバー シグニチャの配列は 1 次元で、下限を 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 が発生します。 これは 2 つの方法で修正できます。

• パラメーターに "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 ランタイム コンポーネントの作成