注释这个编程技巧,对于开发人员来说是非常重要的。尤其是初学者,一定要养成编写代码时注释的好习惯,这样才能帮助我们理清代码结构,方便我们将来的检查,更改等操作。今天为大家带来的就是有关VB.NET注释的一些正确使用方法。
阅读代码示例时,经常会遇到注释符号 (')。此符号通知 Visual Basic 编译器忽略在它后面的文本(即注释)。注释是为了方便阅读而为代码添加的简短的解释性说明。
在所有过程的开头加入一段说明过程功能特征(过程的作用)的简短注释是一个很好的编程做法。这对您自己和检查代码的任何其他人都有好处。应该把实现的详细信息(过程实现的方式)与描述功能特征的注释分开。若给说明加入了实现的详细信息,切记在更新函数时对这些详细信息进行更新。
VB.NET注释可以和语句同行并跟随其后,也可以另占一整行。以下代码阐释了这两种情况。
- Visual Basic
- ' This is a comment beginning at the left edge of the screen.
- text1.Text = "Hi!" ' This is an inline comment.
如果注释需要多行,请在每行的前面使用VB.NET注释符号,如以下示例所示。
- Visual Basic
- ' 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.
VB.NET注释原则
下表提供了在一段代码前可以加上哪些类型的注释的一般原则。这些原则仅为建议;Visual Basic 并未强制实施有关添加注释的规则。编写注释时,应编写对您和代码的任何其他读者都最为有效的注释。#t#
VB.NET注释类型以及注释说明
用途
描述过程的用途(而不是其实现方式)
假设
列举每个外部变量、控件、打开的文件或过程访问的其他元素
效果
列举每个受影响的外部变量、控件、文件以及它的作用(仅在作用不明显时列举)
输入
指定参数的用途
返回
说明过程返回的值
请记住以下几点:
每个重要的变量声明前都应有注释,用以描述被声明变量的用途。
变量、控件和过程的命名应当足够清楚,使得只在遇到复杂的实现详细情况时才使用注释。
VB.NET注释不能与行继续符同行。
通过选择一行或多行代码,然后在“编辑”工具栏上选择“注释”按钮和“取消注释” 按钮,可以添加或移除某段代码的注释符。
注意
也可以用在文本前加关键字 REM 的方式给代码添加VB.NET注释。但符号 ' 和“注释”/“取消注释”按钮更易于使用,而且需要的空间和内存更少。