Upozornění kompilátoru (úroveň 1) CS1723

Komentář XML má atribut cref attribute, který odkazuje na parametr typu.

Tato chyba se vygeneruje pro komentář XML v případě použití <see> značky s křížovým odkazem (cref) na parametr typu místo existujícího typu (bez ohledu na to, jestli je definovaný uživatelem nebo předdefinovaný) v kódu. Není možné propojit s atributem obecných typů, protože v okamžiku vytvoření dokumentace budoucí typ zadaný jako atribut ještě není známý.

Pokud chcete tento problém vyřešit, použijte <typeparamref> značku.

Example

Následující příklad obsahuje komentář generující CS1723 a také odkaz, který lze propojit správně.

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

Další příklad ukazuje, jak správně propojit obecný typ T i již známý uživatelem definovaný 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>
{
}