首页
网页制作
网络编程
脚本专栏
数据库
网站运营
网络安全
平面设计
CMS教程
搜索
建站极客
软件编程
C#教程
正文
C#注释的一些使用方法浅谈
所属分类:
软件编程
/
C#教程
阅读数: 85
收藏 0
赞 0
分享
C# Coding的时候,常常涉及代码注释,常见的注释包括两类:
1)单行注释。格式:// Comments
2)多行注释。格式:/* Comments... */
C#引入了新的XML注释,即我们在某个函数前新起一行,输入///,VS.Net会自动增加XML格式的注释,这里整理一下可用的XML注释。
XML注释分为一级注释(Primary Tags)和二级注释(Secondary Tags),前者可以单独存在,后者必须包含在一级注释内部。
I 一级注释
1. <remarks>对类型进行描述,功能类似<summary>,据说建议使用<remarks>;
2. <summary>对共有类型的类、方法、属性或字段进行注释;
3. <value>主要用于属性的注释,表示属性的制的含义,可以配合<summary>使用;
4. <param>用于对方法的参数进行说明,格式:<param name="param_name">value</param>;
5. <returns>用于定义方法的返回值,对于一个方法,输入///后,会自动添加<summary>、<param>列表和<returns>;
6. <exception>定义可能抛出的异常,格式:<exception cref="IDNotFoundException">;
7. <example>用于给出如何使用某个方法、属性或者字段的使用方法;
8. <permission>涉及方法的访问许可;
9. <seealso>用于参考某个其它的东东:),也可以通过cref设置属性;
10. <include>用于指示外部的XML注释;
II 二级注释
1. <c> or <code>主要用于加入代码段;
2. <para>的作用类似HTML中的<p>标记符,就是分段;
3. <pararef>用于引用某个参数;
4. <see>的作用类似<seealso>,可以指示其它的方法;
5. <list>用于生成一个列表;
另外,还可以自定义XML标签
更多精彩内容
其他人还在看
C# SendInput 模拟鼠标操作的实现方法
C# SendInput 模拟鼠标操作的实现方法,需要的朋友可以参考一下
评论 0
收藏 0
赞 0
分享
C#中 paint()与Onpaint()的区别
paint是事件onpaint方法onpaint方法是调用paint事件的,用哪一个,效果是一样,就看那一个方便了内部是这样实现的:
评论 0
收藏 0
赞 0
分享
c#中GetType()与Typeof()的区别
c#中GetType()与Typeof()的区别,需要的朋友可以参考一下
评论 0
收藏 0
赞 0
分享
将字符串转换成System.Drawing.Color类型的方法
将字符串转换成System.Drawing.Color类型的方法,需要的朋友可以参考一下
评论 0
收藏 0
赞 0
分享
C# 抓取网页内容的方法
C# 抓取网页内容的方法,需要的朋友可以参考一下
评论 0
收藏 0
赞 0
分享
基于C#后台调用跨域MVC服务及带Cookie验证的实现
本篇文章介绍了,基于C#后台调用跨域MVC服务及带Cookie验证的实现。需要的朋友参考下
评论 0
收藏 0
赞 0
分享
使用C#获取远程图片 Form用户名与密码Authorization认证的实现
本篇文章介绍了,使用C#获取远程图片 Form用户名与密码Authorization认证的实现。需要的朋友参考下
评论 0
收藏 0
赞 0
分享
Winform跨线程操作的简单方法
线程间操作无效:从不是创建控件“label1”的线程访问它
评论 0
收藏 0
赞 0
分享
C# WINFORM 强制让窗体获得焦点的方法代码
C# WINFORM 强制让窗体获得焦点的方法代码,需要的朋友可以参考一下
评论 0
收藏 0
赞 0
分享
C#中方括号[]的语法及作用介绍
C#中方括号[]可用于数组,索引、属性,更重要的是用于外部DLL类库的引用。
评论 0
收藏 0
赞 0
分享
查看更多
网络赚钱
更多
让所谓“网络营销”的人哭笑不得:一个圈外人士的真实网赚经历
站长VS微商 你选择哪个?
贴吧引流变现,高调创收!
浅谈一下个人站长领域的灰色地带有多么的暴利
企业网站通过流量变现有哪些关键的环节需要注意?
为什么做网站不赚钱?做网站不赚钱的三大原因
站长故事
更多
站长故事:一个80后妈妈的微商之旅
小白站长:一次网站被 K 的经历
一个日IP2000的网站,我赚了20万
我认识的中国第一网民高春辉
我认识的互联网活化石金山劳模雷军
大学生谈网络赚钱的经历