Peringatan Kompiler (tingkat 1) CS1723

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

Kesalahan ini dihasilkan untuk komentar XML jika menggunakan tag <see> dengan referensi silang (cref) ke parameter tipe alih-alih tipe yang ada (baik yang didefinisikan 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, gunakan <typeparamref> tag.

Example

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

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 berikut menunjukkan cara menautkan jenis generik T dengan benar serta jenis yang sudah dikenal dan ditentukan pengguna 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>
{
}