編譯器警告 (層級 1) CS1723
XML 註解具有參考型別參數的 cref 屬性 ‘attribute'
如果在程式碼中使用具有交互參考 (cref) 至型別參數的 <see/> 標記,而不是程式碼中的現有型別 (無論是使用者定義或內建),則會產生此 XML 註解的錯誤。 無法連結至泛型型別的 ‘attribute',因為建立檔時,尚未知道指定為‘attribute' 的未來型別。
若要解決此問題,應使用 <typeparamref/> 標記。
下列範例包含產生 CS1723 的註解,以及可正確連結的參考。
C#
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
C#
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>
{
}