189 8069 5689

C#中如何规范化注释-创新互联

注释对于增加程序的易读性和可维护性非常重要,同时在编程的过程中,也有助于程序员使其思路更加清晰,降低出现逻辑错误的几率。对于注释的风格,往往采取下面的策略。

成都创新互联是一家专注于网站制作、成都做网站与策划设计,原州网站建设哪家好?成都创新互联做网站,专注于网站建设10年,网设计领域的专业建站公司;建站业务涵盖:原州等地区。原州做网站价格咨询:18980820575

1.文件级注释

文件级注释在于说明整个代码文件的功能,常常还包含作者信息、创建日期信息等,便于代码的后期维护。一个典型的文件级注释如下所示。

  C#中如何规范化注释 

上面示例给出了一个较为典型的文件级注释,读者可以根据自身的情况,指定统一的注释规范。

2.函数级注释

函数级注释用于说明某个函数具体完成的功能、输入参数类型、输出结果等信息,便于函数的调用。一个典型的函数级注释如下所示。

  C#中如何规范化注释 

VS.NET开发环境可以自动生成这个风格的函数注释,只需要在方法前输入"//",VS.NET就自动生成注释框架,开发者只需要在相应的地方填入相应的值就可以了。

这种风格的注释还有其他优点,即当开发者使用这个方法时,VS.NET会给出提示信息。根据上面的例子,在使用SetInfomation方法时VS.NET给出的提示信息。

3.代码功能块级注释

在逻辑严密的方法实现中,常常是一个代码块完成一个特定的子问题,称这样一个代码块为功能块。对于函数的功能块添加注释可以理顺整个函数的功能,尤其体现在行数较多的函数中。如下面的示例所示。

  C#中如何规范化注释 

  C#中如何规范化注释  

如上面的示例,代码功能块级的注释往往可以注释到这个功能块的上面一行,而各个功能块之前使用空行来分隔。有了这样的功能块注释,整个函数的实现逻辑显得更为清晰,便于从整体上把握函数的实现,避免在实现一些逻辑复杂的功能时出现混乱。

4.代码行级注释

除了上面3种注释,还需要在代码行上加必要的注释以进一步增强代码的可读性,当然,并不需要在每一行上都加注释,只需要在比较复杂的某些行上加以注释即可。代码行级的注释往往加在本行的后面,如下所示。

  C#中如何规范化注释

创新互联www.cdcxhl.cn,专业提供香港、美国云服务器,动态BGP最优骨干路由自动选择,持续稳定高效的网络助力业务部署。公司持有工信部办法的idc、isp许可证, 机房独有T级流量清洗系统配攻击溯源,准确进行流量调度,确保服务器高可用性。佳节活动现已开启,新人活动云服务器买多久送多久。


当前文章:C#中如何规范化注释-创新互联
地址分享:http://cdxtjz.cn/article/dhgdhc.html

其他资讯