让 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,直接指定版本,内容如下

< configuration >
< startup >
< supportedRuntime version ="v2.0.50727" />
</ startup >
</ 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 类打开,增加该函数:

private static string GetFullName(Type type)
{
string name;
if (type.FullName == null)
{
Type result = null;
if (type.IsGenericType && !type.IsGenericTypeDefinition)
{
result = type.GetGenericTypeDefinition();
}

else if (type.IsGenericParameter || type.ContainsGenericParameters)
{
return type.Name;
}

if (result == null || result.FullName == null)
{
throw new ArgumentException("Incomplete type: " + (result != null ? result : type), "type");
}

name = result.FullName;
}

else
{
name = type.FullName;
}

return name;
}


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

private string GetMemberName(Type type)
{
//原始的为 return "T:" + type.FullName.Replace('+','.');
return "T:" + GetFullName(type).Replace('+', '.');
}

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

/Files/Chinasf/ReflectionEngine.rar

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

9:58 2006-6-8




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

相关文章
|
3月前
|
XML JSON API
ServiceStack:不仅仅是一个高性能Web API和微服务框架,更是一站式解决方案——深入解析其多协议支持及简便开发流程,带您体验前所未有的.NET开发效率革命
【10月更文挑战第9天】ServiceStack 是一个高性能的 Web API 和微服务框架,支持 JSON、XML、CSV 等多种数据格式。它简化了 .NET 应用的开发流程,提供了直观的 RESTful 服务构建方式。ServiceStack 支持高并发请求和复杂业务逻辑,安装简单,通过 NuGet 包管理器即可快速集成。示例代码展示了如何创建一个返回当前日期的简单服务,包括定义请求和响应 DTO、实现服务逻辑、配置路由和宿主。ServiceStack 还支持 WebSocket、SignalR 等实时通信协议,具备自动验证、自动过滤器等丰富功能,适合快速搭建高性能、可扩展的服务端应用。
180 3
|
9天前
|
存储 JSON 开发工具
.NET 在 Visual Studio 中的高效编程技巧集
.NET 在 Visual Studio 中的高效编程技巧集
35 12
|
30天前
|
算法 Java 测试技术
Benchmark.NET:让 C# 测试程序性能变得既酷又简单
Benchmark.NET是一款专为 .NET 平台设计的性能基准测试框架,它可以帮助你测量代码的执行时间、内存使用情况等性能指标。它就像是你代码的 "健身教练",帮助你找到瓶颈,优化性能,让你的应用跑得更快、更稳!希望这个小教程能让你在追求高性能的路上越走越远,享受编程带来的无限乐趣!
89 13
|
3月前
|
监控 网络安全 调度
Quartz.Net整合NetCore3.1,部署到IIS服务器上后台定时Job不被调度的解决方案
解决Quartz.NET在.NET Core 3.1应用中部署到IIS服务器上不被调度的问题,通常需要综合考虑应用配置、IIS设置、日志分析等多个方面。采用上述策略,结合细致的测试和监控,可以有效地提高定时任务的稳定性和可靠性。在实施任何更改后,务必进行充分的测试,以验证问题是否得到解决,并监控生产环境的表现,确保长期稳定性。
138 1
|
4月前
|
存储 安全 物联网
.NET 跨平台工业物联网网关解决方案
【9月更文挑战第28天】本文介绍了利用 .NET 构建跨平台工业物联网网关的解决方案。通过 .NET Core 和多种通信协议(如 MQTT 和 Modbus),实现工业设备的高效接入和数据采集。系统架构包括设备接入层、数据处理层、通信层、应用层和数据库层,确保数据的准确采集、实时处理和安全传输。此外,还详细阐述了设备身份认证、数据加密及安全审计等机制,确保系统的安全性。该方案适用于不同操作系统和工业环境,具备高度灵活性和扩展性。
106 1
|
3月前
|
前端开发 JavaScript C#
CodeMaid:一款基于.NET开发的Visual Studio代码简化和整理实用插件
CodeMaid:一款基于.NET开发的Visual Studio代码简化和整理实用插件
|
4月前
|
Ubuntu 持续交付 API
如何使用 dotnet pack 打包 .NET 跨平台程序集?
`dotnet pack` 是 .NET Core 的 NuGet 包打包工具,用于将代码打包成 NuGet 包。通过命令 `dotnet pack` 可生成 `.nupkg` 文件。使用 `--include-symbols` 和 `--include-source` 选项可分别创建包含调试符号和源文件的包。默认情况下,`dotnet pack` 会先构建项目,可通过 `--no-build` 跳过构建。此外,还可以使用 `--output` 指定输出目录、`-c` 设置配置等。示例展示了创建类库项目并打包的过程。更多详情及命令选项,请参考官方文档。
261 11
|
3月前
|
XML 存储 安全
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
138 0
|
4月前
|
存储 运维
.NET开发必备技巧:使用Visual Studio分析.NET Dump,快速查找程序内存泄漏问题!
.NET开发必备技巧:使用Visual Studio分析.NET Dump,快速查找程序内存泄漏问题!
|
4月前
|
自然语言处理 C# 图形学
使用dnSpyEx对.NET Core程序集进行反编译、编辑和调试
使用dnSpyEx对.NET Core程序集进行反编译、编辑和调试