コンパイラの警告 (レベル 1) CS1723

XML コメントには、型パラメーターを参照する cref 属性 'attribute' があります。

このエラーは、コード内の既存の型 (ユーザー定義か組み込みかにかかわらず) ではなく、型パラメーターへのクロス参照 (cref) を持つ <see> タグを使用する場合に、XML コメントに対して生成されます。 ドキュメントを作成する時点で、'attribute' として指定された将来の型がまだわかっていないため、ジェネリック型の 'attribute' にリンクすることはできません。

この問題を解決するには、 <typeparamref> タグを使用します。

Example

次の例には、CS1723 を生成するコメントと、正しくリンクできる参照が含まれています。

public class Point
{
}

// compile with: /t:library /doc:filename.XML
///<summary>A generic list class.</summary>
///uses <see cref="T" />      // CS1723
///and <see cref="Point" />   // No warning
public class List<T, Point>
{
}

次の例では、ジェネリック型 T と、既に知られているユーザー定義 Pointの両方を正しくリンクする方法を示します。

public class Point
{
}

// compile with: /t:library /doc:filename.XML
///<summary>A generic list class.</summary>
///uses <typeparamref name="T" />  // No warning
///and <see cref="Point" />        // No warning
public class List<T, Point>
{
}