VB.NET注释正确使用方法介绍
创始人
2024-06-21 11:01:52
0

注释这个编程技巧,对于开发人员来说是非常重要的。尤其是初学者,一定要养成编写代码时注释的好习惯,这样才能帮助我们理清代码结构,方便我们将来的检查,更改等操作。今天为大家带来的就是有关VB.NET注释的一些正确使用方法。

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

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

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

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

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

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

VB.NET注释原则

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

VB.NET注释类型以及注释说明

用途

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

假设

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

效果

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

输入

指定参数的用途

返回

说明过程返回的值

请记住以下几点:

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

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

VB.NET注释不能与行继续符同行。

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

注意

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

相关内容

热门资讯

如何允许远程连接到MySQL数... [[277004]]【51CTO.com快译】默认情况下,MySQL服务器仅侦听来自localhos...
如何利用交换机和端口设置来管理... 在网络管理中,总是有些人让管理员头疼。下面我们就将介绍一下一个网管员利用交换机以及端口设置等来进行D...
施耐德电气数据中心整体解决方案... 近日,全球能效管理专家施耐德电气正式启动大型体验活动“能效中国行——2012卡车巡展”,作为该活动的...
Windows恶意软件20年“... 在Windows的早期年代,病毒游走于系统之间,偶尔删除文件(但被删除的文件几乎都是可恢复的),并弹...
20个非常棒的扁平设计免费资源 Apple设备的平面图标PSD免费平板UI 平板UI套件24平图标Freen平板UI套件PSD径向平...
德国电信门户网站可实时显示全球... 德国电信周三推出一个门户网站,直观地实时提供其安装在全球各地的传感器网络检测到的网络攻击状况。该网站...
着眼MAC地址,解救无法享受D... 在安装了DHCP服务器的局域网环境中,每一台工作站在上网之前,都要先从DHCP服务器那里享受到地址动...
为啥国人偏爱 Mybatis,... 关于 SQL 和 ORM 的争论,永远都不会终止,我也一直在思考这个问题。昨天又跟群里的小伙伴进行...