Visual Basic 2005在语言上的增强(三)XML注释

作者:袖梨 2022-07-02
XML注释允许你在代码中添加结构化的文档,并且因为这是C#最先采用的技术,Visual Basic程序员觊觎已久了。XML注释能够描述各种各样的代码元素,包括类、字段成员、方法、以及枚举等等。
一旦你创建了一个描述代码特性的XML注释,当你继续在编辑器里键入代码特性时,你立刻会得到关于参数和返回值的智能感知。假设你现在有一个标志着如下签名的函数原型:
Private Function GetCustomerData(ByVal CustomerCode As String) As DataSet
把代码插入点设置在这个函数声明的上一行并键入三个小撇号。Visual Basic将生成一个和下面函数声明相匹配的XML注释,你可以像填充一个表格那样地填充它。根据你的函数,假设你将你的注释模板填充成如下内容:
'''
''' Returns a DataSet for a single customer.
'''

''' Customer Code as String.
''' DataSet for the supplied CustomerCode.
''' Resides in the application's data layer.
现在你无论在代码的何处键入这个函数名,你都会得到关于这个函数的概要、参数、和返回值的信息的完整智能感知,如图5所示:
图5 当你为你的代码元素添加了XML注释后,你可以立即得到其智能感知反馈,正如这个工具提示所展示的那样。
如果你是在集体协作下完成开发,这就是一个关键的特性。通过插入在源文件中的结构化的XML注释,你可以生成代码文档。并且,一个应用程序的架构师或开发组长可以在实现代码具体细节之前,先设计出原型并给出特性的注释。当开发人员在根据原型填写代码时,智能感知可以指导他们正确地使用到原型的特性。
编译器将把XML注释看作你代码的一部分。注释标签值显示成注释的颜色,而若你没有完整地规划出XML注释的话(作者意思是没有设计完整的函数原型,例如没有给出参数列表,涕淌注),只有summary标签值会显示在完整的XML注释模板上(见图6)。

相关文章

精彩推荐