代码中的注释

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

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

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

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

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

请记住以下几点：

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

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

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

可以按以下方法添加或删除一段代码块的注释符号：选中一行或多行代码，并选择“编辑”工具栏上的“注释”() 和“取消注释”() 按钮。

注意

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