代码注释 - ///**/

C# 支持两种不同形式的注释。 单行注释以 // 开头,并在该代码行末尾结束。 多行注释以 /* 开头,以 */ 结尾。 下面的代码示例演示了每种注释:

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

多行注释还可用于在代码行中插入文本。 由于这些注释具有显式结束字符,因此可以在注释后面加上更多可执行代码:

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

单行注释可以出现在同一行上的可执行代码之后。 注释在文本行末尾结束:

return source++; // increment the source.

某些注释以三个斜杠开头:///。 三斜杠注释是 XML 文档注释。 编译器读取这些注释以生成人工文档。 有关 XML 文档注释的详细信息,请参阅三斜杠注释部分。