閱讀英文

共用方式為


編譯器警告 (層級 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>
{
}