Baca dalam bahasa Inggris

Bagikan melalui


Peringatan Pengompilasi (level 1) CS1723

Komentar XML memiliki atribut cref 'atribut' yang mengacu pada parameter jenis

Kesalahan ini dihasilkan untuk komentar XML jika menggunakan <tag lihat/> dengan referensi silang (cref) ke parameter jenis alih-alih jenis yang ada (baik yang ditentukan pengguna atau bawaan) dalam kode. Tidak mungkin untuk menautkan ke 'atribut' jenis generik karena pada saat membuat dokumentasi jenis masa depan yang diberikan sebagai 'atribut' belum diketahui.

Untuk mengatasi masalah <ini, tag typeparamref/> harus digunakan.

Contoh

Contoh berikut berisi komentar yang menghasilkan CS1723 serta referensi yang dapat ditautkan dengan benar.

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>
{
}

Contoh ini menunjukkan cara menautkan jenis generik dengan benar serta yang T sudah diketahui pengguna yang ditentukan 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>
{
}