İngilizce dilinde oku

Aracılığıyla paylaş


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.

Örnek

Aşağıdaki örnek, CS1723 oluşturan bir açıklamanın yanı sıra doğru şekilde bağlanabilen bir başvuru içerir.

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

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

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