代码注释 - //
和 /*
。 */
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 文档注释的详细信息,请参阅三斜杠注释部分。