Commentaires de code : //
et /*
. */
C# prend en charge deux formes différentes de commentaires. Les commentaires à une seule ligne commencent par //
et se terminent à la fin de cette ligne de code. Les commentaires multilignes commencent par /*
et se terminent par */
. Le code suivant présente un exemple de chaque :
// 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
*/
Le multi-commentaire de ligne peut également être utilisé pour insérer du texte dans une ligne de code. Puisque ces commentaires présentent un caractère fermant explicite, vous pouvez inclure plus de code exécutable après le commentaire :
public static int Add(int left, int right)
{
return left /* first operand */ + right /* second operand */;
}
Le commentaire à ligne unique peut apparaître à la suite du 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 à trois barres obliques sont des commentaires de documentation XML. Le compilateur les lit pour produire une documentation humaine. Vous pouvez en savoir plus concernant les commentaires de documents XML dans la section sur les commentaires à triple barre oblique.