代码中的注释 (Visual Basic)

阅读代码示例时,经常会遇到注释符号 (')。 此符号通知 Visual Basic 编译器忽略在它后面的文本(即注释)。 注释是为了方便阅读而为代码添加的简短的解释性说明。

在所有过程的开头加入一段说明过程功能特征(过程的作用)的简短注释是一个很好的编程做法。 这对您自己和检查代码的任何其他人都有好处。 应该把实现的详细信息(过程实现的方式)与描述功能特征的注释分开。 若给说明加入了实现的详细信息,切记在更新函数时对这些详细信息进行更新。

注释可以和语句同行并跟随其后,也可以另占一整行。 以下代码阐释了这两种情况。

' This is a comment beginning at the left edge of the screen.
text1.Text = "Hi!"   ' This is an inline comment.

如果注释需要多行,请在每行的前面使用注释符号,如以下示例所示。

' This comment is too long to fit on a single line, so we break  
' it into two lines. Some comments might need three or more lines.

注释原则

下表提供了在一段代码前可以加上哪些类型的注释的一般原则。 这些准则仅仅是一些建议;Visual Basic 并未强制实施有关添加注释的规则。 编写注释时,应编写对您和代码的任何其他读者都最为有效的注释。

注释类型

注释说明

用途

描述过程的用途(而不是其实现方式)

假设

列举每个外部变量、控件、打开的文件或过程访问的其他元素

效果

列举每个受影响的外部变量、控件、文件以及它的作用(仅在作用不明显时列举)

输入

指定参数的用途

返回

说明过程返回的值

请记住以下几点:

  • 每个重要的变量声明前都应有注释,用以描述被声明变量的用途。

  • 变量、控件和过程的命名应当足够清楚,使得只在遇到复杂的实现详细情况时才使用注释。

  • 注释不能与行继续符同行。

通过选择一行或多行代码,然后在**“编辑”工具栏上选择“注释”(VisualBasicWinAppCodeEditorCommentButton) 按钮和“取消注释”**(VisualStudioWinAppProjectUncommentButton) 按钮,可以添加或移除某段代码的注释符。

备注

也可以用在文本前加关键字 REM 的方式给代码添加注释。但符号 ' 和“注释”/“取消注释”按钮更易于使用,而且需要的空间和内存更少。

请参见

任务

如何:在 Visual Basic 中创建 XML 文档

参考

建议的用于文档注释的 XML 标记 (Visual Basic)

REM 语句 (Visual Basic)

其他资源

使用 XML 注释来记录你的代码

程序结构和代码约定 (Visual Basic)