Derleyici Uyarısı (düzey 1) CS1723
XML açıklaması, tür parametresine başvuran 'attribute' cref özniteliğine sahip
Bu hata, koddaki mevcut tür (kullanıcı tanımlı veya yerleşik) yerine tür parametresine çapraz başvurulu (cref) see/> etiketi kullanılması <durumunda XML açıklaması için oluşturulur. Genel türlerin 'özniteliğine' bağlanmak mümkün değildir, çünkü belgeleri oluştururken gelecekte 'öznitelik' olarak verilen tür henüz bilinmemektedir.
Bu sorunu <çözmek için typeparamref/> etiketi kullanılmalıdır.
Aşağıdaki örnek, CS1723 oluşturan bir açıklamanın yanı sıra doğru şekilde bağlanabilen bir başvuru içerir.
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>
{
}
Bu örnekte hem genel türün hem de zaten bilinen kullanıcı tanımlı türün T
doğru şekilde nasıl bağlandığı gösterilmektedir 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>
{
}
.NET geri bildirimi
.NET, açık kaynak bir projedir. Geri bildirim sağlamak için bir bağlantı seçin: