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/>.
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>
{
}
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: