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报表。为转换这些报表，需要先执行如下操作：

• 把继承报表对象的基类改为ActiveReport
• 确认报表对象的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环境中的相应语言进行重写。