Derleyici Uyarısı (düzey 1) CS1723

XML açıklaması, 'attribute' tür parametresine başvuran bir cref özniteliğine sahiptir.

Bu hata, XML açıklamasında kodda var olan bir tür (kullanıcı tanımlı veya yerleşik) yerine tür parametresine çapraz başvuru (cref) içeren <see> etiketinin kullanılması durumunda 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 etiketini kullanın <typeparamref> .

Example

Aşağıdaki örnek, CS1723 oluşturan bir yorumu ve ayrıca doğru şekilde bağlanabilen bir başvuruyu 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>
{
}

Sonraki örnekte hem genel türün T hem de zaten bilinen kullanıcı tanımlı Pointöğesinin doğru şekilde nasıl bağlandığı gösterilmektedir.

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