C# <summary> 三纲注释的设置问题
2012-04-26 17:52
274 查看
C#中新建的类库添加注释时,应注意以下问题:
1、编译动态类库时命名空间要规范,一般不要和类同名,命名空间一般定义格式:项目名+类文件名;
2、动态类库中,类、方法的注释都采用下列方式注释:
类注释的格式:
/// <summary>
/// 文件名:Ini处理类/
/// 文件功能描述:读写Ini文件/
/// 版权所有:Copyright (C) ZGM/
/// 创建标识:2011.12.13/ /// 修改描述:/
/// </summary>
方法注释的格式:
/// <summary>
/// 读出Ini文件
/// </summary>
/// <param name="Section">Ini文件中的段落名称</param>
/// <param name="Key">Ini文件中的关键字</param>
/// <param name="IniFilePath">Ini文件的完整路径和名称</param>
/// <returns>Ini文件中关键字的数值</returns>
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/1a975222720e0cf34ae62bb40a46f21fbf09aab6.jpg)
3 、生成与动态类库相同名称的xml文件,具体设置是:项目右键—>属性—>生成—>XML文档文件选中再编译
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/d34778b7d0a20cf4ff809b9076094b36adaf99b7.jpg)
4、引用动态类库时,把类库和同名的xml文件放到同一个文件夹内即可。
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/58dec4f41bd5ad6e3a8acda581cb39dbb7fd3c50.jpg)
5、效果如下:
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/c8621333c895d143e57b816c73f082025baf07b1.jpg)
原文地址:http://hi.baidu.com/jiang_yy_jiang/blog/item/78da74092a314d3a6a60fb53.html
1、编译动态类库时命名空间要规范,一般不要和类同名,命名空间一般定义格式:项目名+类文件名;
2、动态类库中,类、方法的注释都采用下列方式注释:
类注释的格式:
/// <summary>
/// 文件名:Ini处理类/
/// 文件功能描述:读写Ini文件/
/// 版权所有:Copyright (C) ZGM/
/// 创建标识:2011.12.13/ /// 修改描述:/
/// </summary>
方法注释的格式:
/// <summary>
/// 读出Ini文件
/// </summary>
/// <param name="Section">Ini文件中的段落名称</param>
/// <param name="Key">Ini文件中的关键字</param>
/// <param name="IniFilePath">Ini文件的完整路径和名称</param>
/// <returns>Ini文件中关键字的数值</returns>
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/1a975222720e0cf34ae62bb40a46f21fbf09aab6.jpg)
3 、生成与动态类库相同名称的xml文件,具体设置是:项目右键—>属性—>生成—>XML文档文件选中再编译
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/d34778b7d0a20cf4ff809b9076094b36adaf99b7.jpg)
4、引用动态类库时,把类库和同名的xml文件放到同一个文件夹内即可。
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/58dec4f41bd5ad6e3a8acda581cb39dbb7fd3c50.jpg)
5、效果如下:
![](http://hiphotos.baidu.com/jiang_yy_jiang/pic/item/c8621333c895d143e57b816c73f082025baf07b1.jpg)
原文地址:http://hi.baidu.com/jiang_yy_jiang/blog/item/78da74092a314d3a6a60fb53.html
相关文章推荐
- C#xml<summary>注释 换行、空行
- C# &lt;summary&gt;注释
- Android ListView中设置的字体颜色显示错乱问题 && SparseArray<E>的使用
- C# ASP.NET调试问题<compilation debug="false" targetFramework="4.0"/>
- C#中泛型集合List<T>反序列化问题及解决方法
- struts2 <s:textfield> value属性设置问题
- C#中使用List<struct>的问题
- C#中List<T>对象的深度拷贝问题
- C#自动产生注释<summary>
- Tomcat设置<welcome-file>显示首页问题
- C#中List<T>对象的深度拷贝问题
- C#制作QQ截图的自动框选功能的个人思路(二)<设置Hook>
- C# VS2010发布问题---<compilation debug="true" targetFramework="4.0">
- nodeJS学习(7)--- WS开发 NodeJS 项目-节2 <安装&设置&启动 mongodb 数据库++遇到的问题>
- 开发日志:设置<DIV>内容不自动换行,及inline后width和height等失效的问题
- List<> 转换为Dataset的C#代码实现 解决Nullable问题
- XML的注释格式一般是这样 <!-- 设置右对齐 -->
- C#中list<T>性能内存优化分配,Capacity设置
- C#中List<T>对象的深度拷贝问题
- JQuery<Select>在IE下设置选中问题