Leer en inglés

Compartir a través de


Advertencia del compilador (nivel 1) CS1723

El comentario XML tiene un atributo "attribute" que hace referencia a un parámetro de tipo

Este error se genera para un comentario XML en caso de usar una etiqueta <see/> 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 "attribute" de tipos genéricos porque en el momento de crear la documentación el tipo futuro dado como "attribute" todavía no se conoce.

Para resolver esta incidencia, se debe usar la etiqueta <typeparamref/>.

Ejemplo

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 este ejemplo se muestra cómo vincular correctamente ambos tipos genéricos T, así como Point definido por el usuario ya conocido.

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