注释

C#用传统的C注释风格方式:

单行注释
//…

多行注释
/*

*/

单行注释中的任何内容,即从//开始一直到行尾的内容都会被编译器忽略。多行注释中 “/*”和 “*/”之间的所有内容也会被忽略。显然不能在多行注释中包含 “*/” 组合,因为这会被当作注释的结尾。

实际上,可以把多行注释放在一行代码。

XML注释

C#可以根据特定的注释自动创建XML格式的文档说明。这些注释都是单行注释,但都以3条斜杠(///)开头。

把行中的内容标记为代码
将多行标记为代码
标记为一个代码示例
说明一个异常类
包含其他文档中的注释
把列表插入到文档中
标记方法的参数
表示一个单词是方法的参数
说明对成员的访问
给成员添加描述
说明方法的返回值
提供对另一个参数的交叉引用
提供描述中的
“参见”部分

提供类型或成员的的简短小结
描述属性

Posted in C#

发表回复

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据