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”选项。

[1] [2] 下一页

然后,ghostdoc 就会根据该方法的类型、参数、名称和其他上下文信息为其自动生成 xml 注释文本。
如果您正在 .net framework 中为使用某个类型的属性或方法生成文档,则 ghostdoc 将会使用 microsoft 已为该类型编写的文档。如果您使用 pascal 大小写格式或 camel 大小写格式,ghostdoc 可将该名称拆分成几个单词,并分析这些单独的单词,以生成文档。所有的文档逻辑都按照 ghostdoc 的生成规则来处理。既可以对这些内置规则进行自定义,也可以添加新的规则。还可以导出这些规则,以便在其他计算机上使用。
除最简单的成员外,您不能完全依赖 ghostdoc 为您编写 xml 注释。ghostdoc 自动生成的注释只是建议,还需开发人员进行审核。无论如何,ghostdoc 是一个值得一试的注释编写插件,它可以节省大量时间。

上一页  [1] [2] 

上一篇:
下一篇:
 
网页模板 网站模板 网站建设 网页设计 网页设计师兼职 自助建站 ...
网站魔坊,网页模板,网站模板,免费网页模板,在线模板设计,免费建站,门户网站搭建,建站,企业网站,奇思网络,奇思,智能建站,自助建站,拖动建站,网站建设,网页设计,在线设计模板
www.wzmof.com/ 47K 2009-5-21
 
商巢...
商巢是一个真实的商业交友社区、为用户提供交友、贸易、社区、建站等服务;临渊慕鱼,不如退而结网!商巢结网行动
www.ncooo.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
 
网页设计也通过人脉赚钱-技术传播
 
网页设计114 -打造中国网页设计、网站建设技术信息学习、交流、互动平台
                         打造网页设计师兼职创业平台中心