Avertissement du compilateur (niveau 1) CS1723
Le commentaire XML a l’attribut cref « attribut » qui fait référence à un paramètre de type
Cette erreur est générée pour un commentaire XML en cas d’utilisation d’une balise <see/> avec une référence croisée (cref) à un paramètre de type à la place du type existant (qu’il soit défini par l’utilisateur ou prédéfini) dans le code. Il est impossible d’établir un lien vers le « attribute » des types génériques, car au moment de la création de la documentation, le futur type indiqué en tant que « attribute » n’est pas encore connu.
Pour résoudre ce problème, utilisez la balise <typeparamref/>.
L’exemple suivant contient un commentaire générant CS1723 ainsi qu’une référence qui peut être liée correctement.
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>
{
}
Cet exemple montre comment lier correctement le type générique T
ainsi que le type Point
défini par l’utilisateur et déjà connu
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>
{
}
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :