.NET中的注释种类,单行注释、多行注释、文档注释。。。

注释不是给编译器看的,而是给程序员看的。是程序员之间交流的一种方式。好的程序员一定要有完善的注释。

.NET注释类型。

1.单行注释  //

a.当代码行比较短时,注释可以放在代码后面。

b.当代码行比较长时,注释一定要放在注释代码上边,而不是下边。

c.快捷键:选中要注释的代码,

注释: ctrl k +ctrl c

取消注释:ctrl k + ctrl u

2.多行注释  /*  */

a.多行注释不能嵌套。

3.文档注释  ///

a.快捷键 在方法头、类 、枚举、接口上边 连续输入 三个斜线(“///”)

VS会自动为我们添加 文档注释。

b.在我们引用有文档注释的 类的对象时,点某方法,或者鼠标悬停,会展现文档注释内容。

c. /// <summary>

/// 功能的描述

/// </summary>

/// <param name="参数名">参数说明</param>

/// <return>返回值描述</return>

--------------------------------------------------------------------------------------------------------------

//                            _ooOoo_
//                           o8888888o
//                           88" . "88
//                           (| -_- |)
//                            O\ = /O
//                        ____/`---‘\____
//                      .   ‘ \\| |// `.
//                       / \\||| : |||// //                     / _||||| -:- |||||- //                       | | \\\ - /// | |
//                     | \_| ‘‘\---/‘‘ | |
//                      \ .-\__ `-` ___/-. /
//                   ___`. .‘ /--.--\ `. . __
//                ."" ‘< `.___\_<|>_/___.‘ >‘"".
//               | | : `- \`.;`\ _ /`;.`/ - ` : | |
//                 \ \ `-. \_ __\ /__ _/ .-` / /
//         ======`-.____`-.___\_____/___.-`____.-‘======
//                            `=---=‘
//
//         .............................................
//                  佛祖镇楼                  BUG辟易
//          佛曰:
//                  写字楼里写字间,写字间里程序员;
//                  程序人员写程序,又拿程序换酒钱。
//                  酒醒只在网上坐,酒醉还来网下眠;
//                  酒醉酒醒日复日,网上网下年复年。
//                  但愿老死电脑间,不愿鞠躬老板前;
//                  奔驰宝马贵者趣,公交自行程序员。
//                  别人笑我忒疯癫,我笑自己命太贱;
//                  不见满街漂亮妹,哪个归得程序员?
时间: 2024-08-03 07:39:33

.NET中的注释种类,单行注释、多行注释、文档注释。。。的相关文章

Java基础入门 - 三种注释及文档注释详解

类似C/C++,Java也支持单行和多行注释 注释中的字符在编译时会被忽略 注释通常为类.变量和方法的主要描述 单行注释 // 注释内容 多行注释 /* 注释内容 */ /* * 注释内容 */ 文档注释 /** * 注释内容 */ 文档注释可使用javadoc工具来生成信息,并输出到HTML文件中,方便记录程序信息 文档注释中可包含一个或多个@标签,每个@标签都在新的一行开始 多个相同的标签应一个接一个的放在一起组成一组 实例:SquareNum.java import java.io.*;

注释的基本使用与文档注释的特殊功能

注释与注解(Annotation)的区别: 注释:解释说明程序代码,并帮忙调试错误(给程序设计师阅读的)文字 注解(Annotation):用于给计算机解释说明的程序 注释分类 单行注释 : //单行注释提示 多行注释: /*多行注释提示*/ 文档注释: /** 文档注释提示*/ 文档注释的常用注解:  注意:文档注释支持html片段 文档注释的神奇妙用 原文地址:https://www.cnblogs.com/qq1452753919/p/10551458.html

【iOS开发-45】Tom猫案例:动画、imageNamed与imageWithContentOfFile对内存影响、图片文件夹放哪儿以及文档注释

今天tom猫案例效果: (1)最傻最笨的办法: --所有的点击都是按钮,只不过有6个有图标的按钮,有些头部.左右脚.肚子.尾巴那块也是一个按钮,只不过没背景没文字没边框的按钮用户按不到而已. --这里的帧动画核心是UIImageView对象的一个属性animationImages,这个属性里面是以数组形式存放的图片.当然还有个重要的方法startAnimating用来播放前面那个属性里面的图片,就形成动画.再当然一下,还有设置时间和播放次数的属性. 注意点: --我们一般把图片放在Images.

python文档注释参数获取

1.docopt模块的用法 1 # _*_ coding:utf-8 _*_ 2 3 4 '''命令行的火车票查看系统 5 Usage: 6 index [-gdtkz] <from> <to> <date> 7 8 Options: 9 -h,--help 显示帮助 10 -g 高铁 11 -d 动车 12 -t 特快 13 -k 快速 14 -z 直达 15 Example: 16 index 上海 北京 2018-5-28 17 18 19 20 ''' 21 2

java文档注释规范(一)

https://blog.csdn.net/huangsiqian/article/details/82725214 Javadoc工具将从四种不同类型的“源”文件生成输出文档:Java语言类的源文件(.java),包注释文件,概述注释文件和其他未处理的文件. 包注释文件(Package Comment File)每个包都有自己的文档注释.有两种方式来创建包注释文件: package-info.java - 可以包含包的声明,包注解(anotation),包注释和Javadoc 标签(tag).

javaOO——引用数据类型数组与文档注释

引用数据类型的数组: 1.引用数据类型数组在语法上和基本数据类型是没有区别的 2.引用类型变量可以使用类.接口或数组来声明. 3.数组引用变量是存放在栈内存(stack)中,数组元素是存放在堆内存(heap)中,通过栈内存中的指针指向对应元素在堆内存中的位置来实现访问. 文档注释: [文档注释]是写在类.方法.成员变量的上面的. 文档注释可以用eclipse导出chm格式的帮助文档,拿给其他人用时,方便他人理解.文档注释被调用的方法,当鼠标移到上面时提醒注释内容. 使用文档注释时,需要在开始的 

springBoot 整合 swagger 展示返回对象的嵌套属性文档注释

spring boot 处理 swagger 嵌套数据展示 在开发的过程中,我们会常常使用swagger做我们的在线文档.我们会在对象的属性上使用@ApiModelProperty 等api注解,但是遇到对象嵌套的时候,如何返回一个嵌套的json文档就需要我们做一些简单的处理 如果只在对象某个属性上使用 @ApiModelProperty 并不会起作用 12345678910111213141516171819202122232425262728293031 @Data@Slf4j@Builde

eclipse中java的单行注释、多行注释、文档注释的快捷键

一.单行注释(也可以多行注释) 1.样式://我是被注释的内容 2.快捷键:ctrl+/   或   ctrl+shift+C 二.多行注释(也可以单行注释) 1.样式:/*我是被注释的内容*/ 2.快捷键:ctrl+shift+/ 三.文档注释 1.样式:/**我是被注释的文档*/ 2.快捷键:Alt+shift+J 3.修改文档注释的文档内容: 打开eclipse Window-->Preferences-->Java-->Code Style --> Code Templat

eclipse中单行注释,多行注释,文档注释

一.单行注释(也可以多行注释) 1.样式://我是被注释的内容 2.快捷键:ctrl+/   或   ctrl+shift+C 二.多行注释(也可以单行注释) 1.样式:/*我是被注释的内容*/ 2.快捷键:ctrl+shift+/ 三.文档注释 1.样式:/**我是被注释的文档*/ 2.快捷键:Alt+shift+J 3.修改文档注释的文档内容: 原文地址:https://www.cnblogs.com/wjune-0405/p/12228689.html