Commentaires de code - // et /* - */

C# prend en charge deux formes de commentaires différentes. Les commentaires de ligne unique commencent par // et se terminent à la fin de cette ligne de code. Les commentaires multilignes commencent par /* et se terminent par */.

Le langage C# documente la version la plus récente de la langue C#. Il contient également la documentation initiale des fonctionnalités dans les préversions publiques pour la prochaine version du langage.

La documentation identifie toute fonctionnalité introduite en premier dans les trois dernières versions de la langue ou dans les préversions publiques actuelles.

Conseil / Astuce

Pour savoir quand une fonctionnalité a été introduite en C#, consultez l’article sur l’historique des versions du langage C#.

Le code suivant montre un exemple de chaque formulaire :

// This is a single line comment.

/* This could be a summary of all the
   code that's in this class.
   You might add multiple paragraphs, or links to pages
   like https://learn.microsoft.com/dotnet/csharp.
   
   You could even include emojis. This example is 🔥
   Then, when you're done, close with
   */

Vous pouvez utiliser un commentaire multiligne pour insérer du texte dans une ligne de code. Étant donné que ces commentaires ont un caractère de fermeture explicite, vous pouvez inclure davantage de code exécutable après le commentaire :

public static int Add(int left, int right)
{
    return left /* first operand */ + right /* second operand */;
}

Un commentaire de ligne unique peut apparaître après le code exécutable sur la même ligne. Le commentaire se termine à la fin de la ligne de texte :

return source++; // increment the source.

Certains commentaires commencent par trois barres obliques : ///. Les commentaires à barres obliques triples sont des commentaires de documentation XML. Le compilateur lit ces commentaires pour produire de la documentation humaine. Vous pouvez en savoir plus sur les commentaires de documentation XML dans la section sur les commentaires à barres obliques triples.