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引用,并且修改代码的编译错误。

clip_image001替换工程的DLL引用

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

 

clip_image001[1]修改代码错误

  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文件。
    clip_image005
  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环境中的相应语言进行重写。

你可能感兴趣的:(Active)