惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

H
Help Net Security
月光博客
月光博客
IT之家
IT之家
B
Blog RSS Feed
T
Tailwind CSS Blog
The GitHub Blog
The GitHub Blog
博客园 - 三生石上(FineUI控件)
MyScale Blog
MyScale Blog
J
Java Code Geeks
Stack Overflow Blog
Stack Overflow Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
博客园 - Franky
博客园 - 叶小钗
阮一峰的网络日志
阮一峰的网络日志
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
U
Unit 42
博客园_首页
B
Blog
V
V2EX
腾讯CDC
Vercel News
Vercel News
量子位
Microsoft Security Blog
Microsoft Security Blog

博客园 - 启明

Web纯前端“旭日图”实现元素周期表 能在多种前端框架下使用的表格控件 控件使用经验-MVP模式+控件封装 最好的Angular2表格控件 跨平台开发的两种方法及其对比 是时候 UWP 了 ! 你的系统也可以拥有“数据透视表”功能! Xamarin 免费了,你能做什么? 使用SQL向SQL Server2005中插入图片 在服务器端修改HTML控件的属性 - 启明 - 博客园 如何调用.Net中的非Public方法 - 启明 - 博客园 IsPostBack深入探讨 ViewState机制由浅入深3 ViewState机制由浅入深2 ViewState机制由浅入深1 MasterPage和内容页之间数据传递 web form事件不提交 如何从开发人员走向架构师(转贴) 195本免费的在线编程类书籍 全是E文
NDoc简介
启明 · 2007-04-03 · via 博客园 - 启明

1、NDoc的作用
他可以将我们在代码编写过程中使用///形成的XML的注释,自动形成多种风格的类库文档。这些风格可以是JavaDoc,MSDN-thml,MSDN-chm,XML等。让我们快速拥有专业级的类库API 文档
 
2、NDoc的获得
NDoc是一个开源项目,由于MS打算要做类似的东西(sandcastle ),作者放弃了后续的开发,其版本停留在1.3X。MS的sandcastle 还是很不好用,而且目前只有控制台界面。NDoc其下载地址如下:
http://ndoc.sourceforge.net/
 
好在有一些好事之徒,继续对它的研究提供了其对.Net 2.0的支持。并且做了汉化其下载地址如下:
http://www.rainsts.net/article.asp?id=382
 
3、NDoc1.3.1中文版For .Net 2.0的使用
 
a、在源代码中加入注释。必须是使用///进行的注释
b、设置项目输出XML文档及其路径。(必须的)
c、生成程序集。
d、打开NDoc,添加要生成文档的程序集。或者添加解决方案程序自动分析出程序集。
e、选择文档引擎(MSDN,XML.....)
f、进行一些设置(也可以使用默认的设置)
g、生成文档
h、查看效果
 
4、注意事项
a、NDoc默认设置对访问控制是public的东东进行处理。我在试验的时候类没有加Public关键字,折腾很久才发现原因。
b、一定要设置生成XML文档,NDoc依赖这个东西
c、NDoc的设置项可以进行修改。比如你可以允许Internal的东东被输出。使用 class Customer,这样定义的类就可以有注释。
d、NDoc还增加了一些自己的标签。比如<example>,举例说明如何使用。
e、中文的用户指南
http://www.percyboy.com/w/ndoc/userguide.aspx