Windows ランタイム コンポーネントでのエラー状態の診断
この記事では、マネージ コードで記述された Windows ランタイム コンポーネントでの制限に関する追加情報について説明します。 ここでは、Winmdexp.exe (Windows ランタイム メタデータ エクスポート ツール) からのエラー メッセージに示されている情報についても説明します。また、「C# および Visual Basic を使用した Windows ランタイム コンポーネント」に記載されている制限事項の情報について補足説明します。
この記事では、すべてのエラーが説明されているわけではありません。 ここで説明するエラーは一般的なカテゴリにまとめられており、各カテゴリには、関連するエラー メッセージの表が示されています。 この表を利用するには、メッセージ テキストで検索するか (プレース ホルダーの特定の値は省略してください)、メッセージ番号で検索してください。 必要な情報が見つからない場合は、この記事の最後にあるフィードバック ボタンをご利用ください。ドキュメントの内容を充実させるためにご協力をお願いします。 フィードバックを送る際には、エラー メッセージを含めてください。 また、Microsoft Connect の Web サイトで問題点をご連絡していただくこともできます。
非同期インターフェイスの実装に関するエラー メッセージで示される型が正しくない
マネージ型の Windows ランタイム コンポーネントは、非同期処理や非同期操作を表すユニバーサル Windows プラットフォーム (UWP) インターフェイス (IAsyncAction、IAsyncActionWithProgress<TProgress>、IAsyncOperation<TResult>、IAsyncOperationWithProgress<TResult、TProgress>) を実装することはできません。 代わりに、.NET には、Windows ランタイム コンポーネントで非同期操作を生成するための AsyncInfo クラスが用意されています。 非同期インターフェイスを実装しようとしたときに Winmdexp.exe により表示されるエラー メッセージでは、このクラスが誤って以前の名前の AsyncInfoFactory として示されます。 .NET には、AsyncInfoFactory クラスは既に含まれていません。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1084 | 型 '{0}' は Windows ランタイムの非同期インターフェイス '{1}' を実装します。 Windows ランタイム型は、非同期インターフェイスを実装できません。 System.Runtime.InteropServices.WindowsRuntime.AsyncInfoFactory クラスを使用して、Windows ランタイムへのエクスポート用に非同期操作を生成してください。 |
注: Windows ランタイムについて言及したエラー メッセージでは、以前の用語が使われています。 現在では、Windows ランタイムはユニバーサル Windows プラットフォーム (UWP) と呼ばれます。 たとえば、Windows ランタイム型は UWP 型と呼ばれています。
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%\...") にあります。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1009 | mscorlib.dll は参照されませんでした。 正しくエクスポートするには、このメタデータ ファイルへの参照が必要です。 |
| WME1090 | コア参照アセンブリを確認できませんでした。 /reference スイッチを使用して mscorlib.dll および System.Runtime.dll が参照されていることを確認してください。 |
演算子のオーバーロードが許可されていない
マネージ コードで記述された Windows ランタイム コンポーネントでは、パブリック型のオーバーロードされた演算子を公開することはできません。
注: エラー メッセージでは、演算子は op_Addition、op_Multiply、op_ExclusiveOr、op_Implicit (暗黙の変換) などのメタデータ名によって識別されます。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1087 | '{0}' は演算子オーバーロードです。 マネージ型は、Windows ランタイムで演算子オーバーロードを公開できません。 |
クラスのコンストラクターに同じ数のパラメーターがある
UWP のクラスは、指定された数のパラメーターを持つコンストラクターを 1 つしか保持できません。たとえば、String 型の 1 つのパラメーターを持つコンストラクターと int 型 (Visual Basic の Integer) の 1 つのパラメーターを持つコンストラクターを両方保持することはできません。 唯一の回避策は、各コンストラクターで異なる数のパラメーターを使うことです。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1099 | 型 '{0}' には、'{1}' 個の引数を持つ複数のコンストラクターがあります。 Windows ランタイム型には、同じ数の引数を持つ複数のコンストラクターがありません。 |
同じ数のパラメーターを持つオーバーロードには既定値を指定する必要がある
UWP では、オーバーロードされたメソッドの 1 つが既定のオーバーロードとして指定されている場合にのみ、同じ数のパラメーターを持つことができます。 「C# および Visual Basic を使用した Windows ランタイム コンポーネント」の「オーバーロードされたメソッド」をご覧ください。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1059 | '{1}.{2}' の複数の {0} パラメーター オーバーロードは、Windows.Foundation.Metadata.DefaultOverloadAttribute で修飾されます。 |
| WME1085 | {1}.{2} の {0} パラメーター オーバーロードには、Windows.Foundation.Metadata.DefaultOverloadAttribute で修飾して既定のオーバーロードとして指定されたメソッドが 1 つだけ必要です。 |
出力ファイルの名前空間のエラーと無効な名前
ユニバーサル Windows プラットフォームでは、Windows メタデータ (.winmd) ファイルに含まれるすべてのパブリック型は、.winmd ファイルの名前を共有する名前空間、またはそのファイル名のサブ名前空間に含まれている必要があります。 たとえば、Visual Studio プロジェクトの名前が 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)。
注意 Winmdexp.exe を直接呼び出し、Windows ランタイム コンポーネントの名前を指定する /out オプションを指定しなかった場合、Winmdexp.exe は、コンポーネント内のすべての名前空間を含めた名前を生成しようとします。 名前空間の名前を変更すると、コンポーネントの名前も変更される場合があります。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME0006 | '{0}' は、このアセンブリに有効な winmd ファイル名ではありません。 Windows メタデータ ファイル内のすべての型は、ファイル名で指定される名前空間のサブ名前空間に存在する必要があります。 このようなサブ名前空間に存在しない型は、ランタイムに見つかりません。 このアセンブリでは、ファイル名として使用できる最も小さい共通の名前空間は '{1}' です。 |
| WME1042 | 入力モジュールには、名前空間内にある少なくとも 1 つのパブリック型を含める必要があります。 |
| WME1043 | 入力モジュールには、名前空間内にある少なくとも 1 つのパブリック型を含める必要があります。 名前空間内で検出された型はプライベートのみです。 |
| WME1044 | パブリック型の名前空間 ('{1}') が、他の名前空間 ('{0}') と共通のプレフィックスを共有していません。 Windows メタデータ ファイル内のすべての型は、ファイル名で指定される名前空間のサブ名前空間に存在する必要があります。 |
| WME1067 | 名前空間名は、大文字小文字だけを変更しても区別されません: '{0}'、'{1}'。 |
| WME1068 | 型 '{0}' に、名前空間 '{1}' と同じ名前を指定することはできません。 |
無効なユニバーサル Windows プラットフォーム型である型をエクスポートする
コンポーネントのパブリック インターフェイスは UWP 型のみを公開する必要があります。 ただし、.NET には、.NET と UWP で若干異なる、よく使用される多くの型のマッピングが用意されています。 これにより、.NET 開発者は、新しい型を習得する代わりに、使い慣れた型を使うことができます。 マップされた .NET 型は、コンポーネントのパブリック インターフェイスで使うことができます。 「C# および Visual Basic を使用した Windows ランタイム コンポーネント」の「Windows ランタイム コンポーネントの宣言型」と「ユニバーサル Windows プラットフォーム型のマネージ コードへの引き渡し」、および「.NET での Windows ランタイム型の対応付け」をご覧ください。
これらのマッピングの多くはインターフェイスです。 たとえば、 IList<T> は UWP インターフェイス 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> が最適と考えられます。
重要: JavaScript では、マネージ型が実装するインターフェイスのリストに最初に現れるインターフェイスが使われます。 たとえば、Dictionary<int, string> を JavaScript コードに返した場合、戻り値の型としてどのインターフェイスを指定しても、IDictionary<int, string> として表示されます。 つまり、後のインターフェイスにメンバーが最初のインターフェイスに含まれていない場合、そのメンバーは JavaScript では認識されません。
注意 JavaScript で利用されるコンポーネントでは、非ジェネリックな IList インターフェイスと IEnumerable インターフェイスを使わないでください。 これらのインターフェイスは、それぞれ IBindableVector と IBindableIterator にマップされます。 これらは、XAML コントロールのバインドをサポートし、JavaScript には参照されません。 JavaScript では、実行時エラー ("関数 'X' に無効なシグネチャがあるため、呼び出せません") が発生します。
| エラー番号 | メッセージ テキスト |
|---|---|
| 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 を参照してください。 |
使うことができない型のフィールドを含む構造体
UWP では、構造体にはフィールドのみを含めることができ、フィールドは構造体にのみ含めることができます。 これらのフィールドはパブリック型である必要があります。 有効なフィールド型には、列挙体、構造体、およびプリミティブ型があります。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1060 | 構造体 {0} には、型 '{2}' のフィールド '{1}' が含まれています。 '{2}' は有効な Windows ランタイム フィールド型ではありません。 Windows ランタイムの構造体に含まれる各フィールドに指定できるのは、UInt8、Int16、UInt16、Int32、UInt32、Int64、UInt64、Single、Double、Boolean、String、Enum、または構造体自体のみです。 |
メンバーのシグネチャ内における配列の制限
UWP では、メンバーのシグネチャ内の配列は 1 次元で、下限を 0 (ゼロ) に指定する必要があります。 myArray[][] (Visual Basic の myArray()()) など、入れ子になった配列型を使うことはできません。
注: この制限は、実装で内部的に使う配列には適用されません。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1034 | メソッド '{0}' は、そのシグネチャに下限が 0 以外の型 '{1}' の配列を指定しています。 Windows ランタイム メソッドのシグネチャ内の配列では、下限を 0 に指定する必要があります。 |
| WME1035 | メソッド '{0}' では、そのシグネチャに型 '{1}' の多次元配列が指定されています。 Windows ランタイム メソッドのシグネチャ内の配列は 1 次元配列にする必要があります。 |
| WME1036 | メソッド '{0}' では、そのシグネチャに型 '{1}' の入れ子になった配列が指定されています。 Windows ランタイム メソッドのシグネチャ内の配列を入れ子にすることはできません。 |
配列パラメーターでは、配列の内容が読み取り可能であるか書き込み可能であるかどうかを指定する必要がある
UWP では、パラメーターは読み取り専用または書き込み専用に指定する必要があります。 パラメーターは、ref (Visual Basic では OutAttribute 属性のない ByRef) とマークすることはできません。 これは配列の内容に適用されるため、配列パラメーターは配列の内容が読み取り専用または書き込み専用であるかどうかを示す必要があります。 out パラメーター (Visual Basic では OutAttribute 属性のある ByRef パラメーター) の方向は明確ですが、値によって渡される配列パラメーター (Visual Basic の ByVal) はマークする必要があります。 「Windows ランタイム コンポーネントに配列を渡す方法」をご覧ください。
| エラー番号 | メッセージ テキスト |
|---|---|
| WME1101 | メソッド '{0}' のパラメーター '{1}' は配列で、{2} と {3} の両方が格納されています。 Windows ランタイムでは、配列パラメーターの内容は、読み取り可能または書き込み可能である必要があります。 属性の 1 つを '{1}' から削除してください。 |
| WME1102 | メソッド '{0}' の出力パラメーター '{1}' は配列ですが、{2} が含まれています。 Windows ランタイムでは、出力配列の内容は書き込み可能です。 '{1}' から属性を削除してください。 |
| WME1103 | メソッド '{0}' のパラメーター '{1}' は配列で、System.Runtime.InteropServices.InAttribute または System.Runtime.InteropServices.OutAttribute のいずれかが指定されています。 Windows ランタイムでは、配列パラメーターに {2} または {3} を指定する必要があります。 これらの属性を削除するか、必要に応じて、適切な Windows ランタイム属性と置き換えてください。 |
| WME1104 | メソッド '{0}' のパラメーター '{1}' は、配列ではなく、{2} または {3} が指定されています。 Windows ランタイムでは、配列でないパラメーターを {2} または {3} でマークすることがサポートされていません。 |
| WME1105 | メソッド '{0}' に、System.Runtime.InteropServices.InAttribute または System.Runtime.InteropServices.OutAttribute が指定されたパラメーター '{1}' があります。 Windows ランタイムでは、System.Runtime.InteropServices.InAttribute または System.Runtime.InteropServices.OutAttribute でパラメーターをマークすることはサポートされていません。 System.Runtime.InteropServices.InAttribute を削除して、System.Runtime.InteropServices.OutAttribute を 'out' 修飾子と置き換えることを検討してください。 メソッド '{0}' に、System.Runtime.InteropServices.InAttribute または System.Runtime.InteropServices.OutAttribute が指定されたパラメーター '{1}' があります。 Windows ランタイムでは、System.Runtime.InteropServices.OutAttribute で ByRef パラメーターをマークすることのみサポートされており、これらの属性の他の使用方法はサポートされていません。 |
| WME1106 | メソッド '{0}' には、配列パラメーター '{1}' が指定されています。 Windows ランタイムでは、配列パラメーターの内容が読み取り可能または書き込み可能である必要があります。 {2} または {3} を '{1}' に適用してください。 |
"value" という名前のパラメーターを持つメンバー
UWP では、戻り値は出力パラメーターであると見なされ、パラメーターの名前は一意である必要があります。 既定では、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" となります。
関連トピック
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示