让 NDoc 1.3 支持.NET 2.0 程序集,泛型输出和 Visual studio 2005 解决方案导入

简介:

最近要做一份sdk手册,就找到NDOC ,到官方下载了最新的版本 NDoc 1.3 英文版安装包,结果发现支持.NET 1.1的程序集的文档生成,因为内部使用了反射机制,那么要支持.NET 2.0 的程序集很简单;

办法有两个:
1、用VS2005 重新编译一下
2、编写一个NDocGui.exe.config,直接指定版本,内容如下

None.gif < configuration >
None.gif < startup >
None.gif < supportedRuntime version ="v2.0.50727" />
None.gif </ startup >
None.gif </ configuration >

ok,经过上面的任何一步之后,就已经支持了.NET 2.0 环境了,但是他是全英文的,生成出来的文档不能达到要求;经过寻找,确定了国内的一个汉化版本,作者是“破宝(percyboy)”,看了测试的效果非常不错,感谢。

http://www.percyboy.com/w/ndoc/ 下最新的汉化版本和它的汉化版本的原始代码;经过比较,它也是基于.NET 1.1 环境,仅支持Visual Studio.net 2003 解决方案导入,那么它仅仅只是汉化了资源,代码部分应该和英文版本的差不多;

首先解决.NET 2.0 环境问题,打开visual studio 2005编译一次,即可。

Visual studio 2005 解决方案导入,核心的代码是NDoc里的VisualStudio工程,下载这个代码包,覆盖原始工程,重新编译即可。解决.NET 2.0 的程序集内有泛型的类或方法,将产生异常,具体错误是 (Type == null) 而访问.FullName 属性,那么将Core工程的ReflectionEngine.cs 类打开,增加该函数:

None.gif private static string GetFullName(Type type)
ExpandedBlockStart.gif ContractedBlock.gif dot.gif {
InBlock.gifstring name;
InBlock.gifif (type.FullName == null)
ExpandedSubBlockStart.gifContractedSubBlock.gifdot.gif{
InBlock.gif Type result = null;
InBlock.gifif (type.IsGenericType && !type.IsGenericTypeDefinition)
ExpandedSubBlockStart.gifContractedSubBlock.gifdot.gif{
InBlock.gif result = type.GetGenericTypeDefinition();
ExpandedSubBlockEnd.gif }

InBlock.gifelse if (type.IsGenericParameter || type.ContainsGenericParameters)
ExpandedSubBlockStart.gifContractedSubBlock.gifdot.gif{
InBlock.gifreturn type.Name;
ExpandedSubBlockEnd.gif }

InBlock.gifif (result == null || result.FullName == null)
ExpandedSubBlockStart.gifContractedSubBlock.gifdot.gif{
InBlock.gifthrow new ArgumentException("Incomplete type: " + (result != null ? result : type), "type");
ExpandedSubBlockEnd.gif }

InBlock.gif name = result.FullName;
ExpandedSubBlockEnd.gif }

InBlock.gifelse
ExpandedSubBlockStart.gifContractedSubBlock.gifdot.gif{
InBlock.gif name = type.FullName;
ExpandedSubBlockEnd.gif }

InBlock.gifreturn name;
ExpandedBlockEnd.gif}


并且将内部那些以 private string Get....(Type type) 命名的函数内部的 type.FullName 都修改为该函数的调用形式即可。
如:

None.gif private string GetMemberName(Type type)
ExpandedBlockStart.gif ContractedBlock.gif dot.gif {
InBlock.gif//原始的为 return "T:" + type.FullName.Replace('+','.');
InBlock.gif
return "T:" + GetFullName(type).Replace('+', '.');
ExpandedBlockEnd.gif}

如果觉得麻烦也没关系,直接下这个代码覆盖;

/Files/Chinasf/ReflectionEngine.rar

以上修改都是基于中文汉化版本修改的,请自行测试。另外再次感谢汉化工作者所做的辛勤劳动,让我工作起来得心应手!

9:58 2006-6-8




本文转自suifei博客园博客,原文链接:http://www.cnblogs.com/Chinasf/archive/2006/06/08/NDoc2005.html,如需转载请自行联系原作者

相关文章
|
29天前
|
IDE 编译器 开发工具
C/C++ IDE环境 (Qt Creator visual studio等) Cmake工程不显示头文件的解决方案
C/C++ IDE环境 (Qt Creator visual studio等) Cmake工程不显示头文件的解决方案
21 0
|
3月前
|
网络协议 Java Linux
Java 异常 java.net.UnknownHostException 的原因和解决方案
Java 异常 java.net.UnknownHostException 的原因和解决方案
445 0
|
4月前
|
存储 安全 编译器
|
1月前
|
Windows
windows server 2019 安装NET Framework 3.5失败,提示:“安装一个或多个角色、角色服务或功能失败” 解决方案
windows server 2019 安装NET Framework 3.5失败,提示:“安装一个或多个角色、角色服务或功能失败” 解决方案
|
1月前
|
C++
Visual Studio 2022编译错误 Error MSB8041-此项目需要MFC库解决方案
Visual Studio 2022编译错误 Error MSB8041-此项目需要MFC库解决方案
|
1月前
|
开发框架 安全 .NET
C# .NET面试系列三:集合、异常、泛型、LINQ、委托、EF!
<h2>集合、异常、泛型、LINQ、委托、EF! #### 1. IList 接口与 List 的区别是什么? IList 接口和 List 类是C#中集合的两个相关但不同的概念。下面是它们的主要区别: <b>IList 接口</b> IList 接口是C#中定义的一个泛型接口,位于 System.Collections 命名空间。它派生自 ICollection 接口,定义了一个可以通过索引访问的有序集合。 ```c# IList 接口包含一系列索引化的属性和方法,允许按索引访问、插入、移除元素等。 由于是接口,它只定义了成员的契约,而不提供具体的实现。类似于 IEnumera
149 2
|
2月前
|
编译器 C++
Visual Studio 2022中创建的C++项目无法使用万能头<bits/stdc++.h>解决方案
Visual Studio 2022中创建的C++项目无法使用万能头<bits/stdc++.h>解决方案
46 0
Visual Studio 2022中创建的C++项目无法使用万能头<bits/stdc++.h>解决方案
|
2月前
|
开发框架 JSON .NET
初学者不会写接口怎么办?微软Visual Studio 2022无脑式API接口创建——Swagger一键导入APIKit快速测试
初学者不会写接口怎么办?微软Visual Studio 2022无脑式API接口创建——Swagger一键导入APIKit快速测试
72 0
|
4月前
|
开发框架 .NET PHP
Web Deploy配置并使用Visual Studio进行.NET Web项目发布部署
Web Deploy配置并使用Visual Studio进行.NET Web项目发布部署
|
4月前
|
消息中间件 存储 NoSQL
.NET开源的处理分布式事务的解决方案
.NET开源的处理分布式事务的解决方案