Advertencia del compilador (nivel 1) CS1723

El comentario XML tiene el atributo cref 'attribute' que hace referencia a un parámetro de tipo.

Este error se genera para un comentario XML en caso de usar una <see> etiqueta con referencia cruzada (cref) a un parámetro de tipo en lugar del tipo existente (ya sea definido por el usuario o integrado) en el código. Es imposible vincular a "atributo" de tipos genéricos porque en el momento de crear la documentación el tipo futuro dado como "atributo" aún no se conoce.

Para resolver este problema, use la <typeparamref> etiqueta .

Example

El ejemplo siguiente contiene un comentario que genera CS1723, así como una referencia que se puede vincular correctamente.

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

En el siguiente ejemplo se muestra cómo vincular correctamente tanto el tipo genérico T como el tipo definido por el usuario 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>
{
}