.net文档生成工具2.0 支持自定义文档生成器【转:http://www.cnblogs.com/lucc/archive/2008/09/05/1284762.html】

相关下载:

.net文档生成工具2.0下载

.net文档生成工具2.0源代码下载

相关连接:

.net文档生成工具使用说明

.net文档生成工具2.0已经完成,在2.0版本中,您将可以创建自定义的文档生成器,生成个性化的文档。本文将介绍如何编写文档生成器。

.net文档生成工具(ADB)使用抽象工厂模式编写,你只需要继承DocumentBuilder并重写Build方法和Filter属性就可以创建自定义的文档生成器。


1. ADB结构图: 
 

2. 主界面和文档生成器的交互:


文档生成器通过主界面提供的IGetData接口获取程序集的成员(类型,方法,属性等),通过IInteract接口同用户交互(如显示进度等)。

3. 如何编写文档生成器:

下面通过编写一个名为TestBuilder的文档生成器说明如何编写文档生成器,TestBuilder只是简单的将选中的成员的名称及其摘要写入一个文本文件中。

工程文件下载

(1) 新建一个.net类库工程(名称为TestBuilder),拷贝ADB目录下的ADB.EXE,ADB.Factories.dll文件和en文件夹到TestBuilder输出目录;

(2) 引用ADB.Factories.dll;


(3) 创建文档生成器配置文件,创建一个名为TestBuilder.builder文件(保存为UTF-8格式),放置在TestBuilder.dll所在的目录下,TestBuilder.builder内容如下

  

Code


(4) 调试配置:


打开TestBuilder的属性页,设置调试启动项:

 

(5) 添加一个名为TestBuilder的类,继承DocumentBuilder,重写Builder方法和Filter属性代码如下:

TestBuilder

生成工程,文档生成器TestBuilder就完成了。


4. 让ADB自动加载自定义的文档生成器


您只需将编写好的包含有自定义的文档生成器的程序集及其配置文件放到ADB.EXE所在的目录中即可,程序集和配置文件名称必须相同,配置文件的扩展名为.builder,如果引用了其他程序集,也要一并拷贝。

5.文档生成器配置文件格式说明

配置文件格式说明

1.CustomBuilder必须有Name和Entry两个属性(区分大小写),同一程序集内可以有多个文档生成器;

2.Entry必须使用类的完全限定名(命名空间.类名);

3.<?xml version="1.0" encoding="utf-8"?>指定的编码必须和文件保存的编码一致。

原文地址:https://www.cnblogs.com/aaa6818162/p/1550878.html