Lire en anglais

Partager via


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/>.

Exemple

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