ActiveReports 6:如何升级旧版本的项目

ActiveReports for .NET 6.0是报表控件ActiveReports的最新版本，在丰富报表设计功能的同时，还增加了Visual Studio 2010支持、Flash报表浏览器、水晶报表文件转换、PDF文件输出、可再分发的最终用户报表设计器等一系列新特性。如果现有的项目基于ActiveReports的旧版本开发，但现在希望使用ActitveReports for .NET 6.0的新功能，就需要把现有的项目升级到6.0上。ActiveReports 6.0提供了一些方便的工具和方法帮助现有用户平滑升级。

升级ActiveReports for .NET 3.0 项目

如果现在的项目使用的是ActiveReports for .NET 3.0，那么有两种升级方式：

一是使用ActiveReports 6.0附带的转换工具（参见下面“升级ActiveReports for .NET 1.0 或2.0项目”）；
二是在Visual Studio中打开工程，用新版本的DLL替换掉旧版本的DLL引用，并且修改代码的编译错误。

替换工程的DLL引用

1. 在Visual Studio中打开需要升级的报表工程。
2. 在解决方案资源管理器中，点击“显示所有文件”按钮。

3. 展开“引用”文件夹，记录下来工程中当前引用的ActiveReports DLL的名字。
4. 右键点击每个 ActiveReports3引用，选择“移除”。
5. 右键点击“引用”文件夹，选择“添加引用…”。
6. 在弹出的添加引用对话框中，选择版本为6.x.xxx.x 的ActiveReports引用。注意，除了与ActiveReports3对应的ActiveReport6引用外，还需要添加GrapeCity ActiveReports Document引用。
7. 点击“确定”按钮增加这些引用并关闭对话框。许多错误出现在Visual Studio的错误列表窗口。

修改代码错误

1. 如果Visual Studio的错误列表窗口没有显示出来，在视图的下拉式菜单中选择“错误列表”。
2. 在错误列表窗口中，双击ActiveReports3没有被定义的警告信息。
3. 在报表代码中，ActiveReports3被高亮显示。把ActiveReports3 改为ActiveReport，这样应该可以消除错误列表中的大部分错误。
4. 在错误列表窗口中，双击ActiveReports3.FetchEventArgs没有被定义的警告信息。
5. 在报表代码中，把ActiveReports3 改为ActiveReport。
6. 关闭报表的设计视图并再次打开，升级完成。

升级ActiveReports for .NET 1.0 或2.0项目

因为ActiveReports 6用C#或Visual Basic.NET代码描述报表布局，用ActiveReports for .NET 1.0和2.0生成的RPX文件需要被转换后才能在新版本上运行。ActiveReports 6包含了一个转换工具来帮助用户轻松完成此转换。

注意，转换工具不支持使用了报表继承的1.0或2.0报表。为转换这些报表，需要先执行如下操作：
1. 把继承报表对象的基类改为ActiveReport
2. 确认报表对象的InitializeReport方法能够被重载。

ActiveReports 从NET 3.0版本开始改变了控件命名规则。在1.0和2.0版本中，控件的名称可以用大小写区分，比如可以用”Test”和”test”表示两个不同的控件，但 ActiveReports 6（和3）要求控件的名称必须是唯一的且不区分大小写。如果装载的RPX文件中包含两个仅用大小写区分名字的控件，装载将会失败。为了避免此问题，需要给每个控件一个单独的名字，并且把代码做相应修改。

运行转换工具转换老版本的RPX文件：

1. 在Visual Studio中打开现有的ActiveReports for .NET 1.0 或2.0工程，报表RPX文件将出现在解决方案资源管理器中。
2. 在工具菜单下，选择 Convert to ActiveReports 6.0 打开ActiveReport报表转换工具，转换工具会列出工程中的所有RPX文件。

3. 点击OK转换报表文件。报表会以C#或者VB文件的形式出现在解决方案资源管理器中，所有ActiveReports老版本的引用也已经被更新。
4. 如果项目代码中使用了rpt.Show方法，错误信息将会出现在错误列表窗口中。为修正次错误，用rpt.Run 代码替代，然后增加一个Viewer control到Form上，并且设置viewer.Document = rpt.Document。

移植ActiveReports 2.0(COM)项目

ActiveReports 6 能够使用ActiveReports 2.0 (COM) 的报表布局文件(RPX)，但需要对其中的脚本代码进行一些修改。必须在ActiveReports 2.0设计器中先把ActiveReports 2.0 的设计文件(DSR/DSX)保存为RPX文件，然后才能被装载到ActiveReports 6当中。因为ActiveReports不会装载RPX文件中的VB代码或脚本代码，这些代码需要用.NET环境中的相应语言进行重写。