| GhostDoc 自动生成 XML 注释 |
| 时间:2009-6-2 10:09:58 作者: 来源: |
| |
将 xml 注释迅速添加到 visual studio 项目中
microsoft ® .net framework 通过 xml 注释简化了记录类、方法、属性及事件的任务。xml 注释是嵌入到源代码注释中的特殊 xml 标记,提供类及其成员的相关元数据。在编译过程中,此元数据会由 visual studio ® 转换为独立的 xml 文件,然后通过使用 microsoft sandcastle project 之类的工具转换为帮助文件。
ghostdoc 会自动生成 xml 注释(单击该图像获得较大视图)
当 xml 注释协助将源代码注释自动转换为 rtf 帮助文档时,仍须写入注释文本,这是一项令很多开发人员感到精疲力尽的工作。为什么不使用自动化来加速这些注释的创建呢?这正是 ghostdoc 1.9.5 试图实现的目标。
ghostdoc 是一个免费的 visual studio 加载项,由 roland weigelt 创建,用来协助编写 xml 注释。一旦安装了 ghostdoc,只要使用它指一指、点一点,就能轻松地自动生成 xml 注释。例如,若要将 xml 注释添加到某个方法中,只需在该方法中右键单击,然后从上下文菜单中选择“document this”选项。
然后,ghostdoc 就会根据该方法的类型、参数、名称和其他上下文信息为其自动生成 xml 注释文本。
如果您正在 .net framework 中为使用某个类型的属性或方法生成文档,则 ghostdoc 将会使用 microsoft 已为该类型编写的文档。如果您使用 pascal 大小写格式或 camel 大小写格式,ghostdoc 可将该名称拆分成几个单词,并分析这些单独的单词,以生成文档。所有的文档逻辑都按照 ghostdoc 的生成规则来处理。既可以对这些内置规则进行自定义,也可以添加新的规则。还可以导出这些规则,以便在其他计算机上使用。
除最简单的成员外,您不能完全依赖 ghostdoc 为您编写 xml 注释。ghostdoc 自动生成的注释只是建议,还需开发人员进行审核。无论如何,ghostdoc 是一个值得一试的注释编写插件,它可以节省大量时间。 上一页 [1] [2]
上一篇:
下一篇:
|
| |
| |
网页模板 网站模板 网站建设 网页设计 网页设计师兼职 自助建站 ...
网站魔坊,网页模板,网站模板,免费网页模板,在线模板设计,免费建站,门户网站搭建,建站,企业网站,奇思网络,奇思,智能建站,自助建站,拖动建站,网站建设,网页设计,在线设计模板
www.wzmof.com/ 47K 2009-5-21
商巢创业 门户创业 商人网络家园 魔坊建站 商业交友
而商巢下的门户,门户又一独立实体与商巢合作,由商巢负责技术的更新以及硬件的支持,门户负责自己领域的市场推广以及相应的售后服务即可。 打破以往门户需要源源不断的技术、硬件投入模式,盈利模式清晰 行业门户以及门户下企业网站由网站魔坊...
mhcy.ncooo.com/ 36K 2009-5-14
奇思网络技术 网站建设 深圳网站建设
中小外贸企业做电子商务,需要从两点技术突围 08-01 企业网站建设 提供网站策划、网站建设、数据库开发至网络营销全套解决方案。能针对客户所处行业,结合营销特征量身订做高质量网站建设方案。 网站推广 怎样使网站的投资得到回报?这需要经验...
www.qsnet.com.cn/ 48K 2009-4-2
深圳艺术网
深圳艺术网,中国艺术网,中国当代艺术网,广东当代艺术网,广东艺术网,南方当代艺术网,深圳美术网,深港美术网,深港艺术网,深港当代艺术网,杜应红,深圳当代艺术创作库,深圳创库,深圳美术,深圳艺术,深圳收藏,深圳艺术收藏,深圳音乐网,深圳舞蹈...
www.szarts.cn/ 119K 2009-6-9
| |
|
|