ActiveReports工作总结1——AR简介

 ActiveReports（以下简称AR）是一款日本开发的报表打印组件，类似于vs2003自带的那个CrystalReports（即水晶报表，简称CR），虽然普及率没CR高，但是在很多对日项目中却普遍使用，而网上资料几乎都是CR，AR的中文资料不是很丰富。

最近一直在用AR，故对AR的使用也有一定经验，所以打算把这些经验总结一下，一方面自己总结巩固一下，一方面也给有这方面需要的朋友参考参考。文章可能有很多错误或不足之处，希望可以和大家一起讨论。

AR的使用其实和CR很像，有CR经验的朋友开发AR肯定会驾轻就熟。对于那些没有报表开发经验的朋友也不要紧，我们下面一步步来，先试着创建一个最简单的报表。

一，准备工作。

我的工作环境是vs2003+vb.net，以下例子就用这个环境，C#和vb.net没啥差别的。

首先，装vs2003，这是废话。

其次，装AR，似乎也是废话，vs2003自带CR，但却不带AR的，所以只能自己装。安装文件google一下，应该很好找，假如不知道下载哪个的话，我回家上传一个。

安装好AR之后，你可以在工具箱里看到多了一个控件Viewer，如图：


 假如没有直接出现的话，可以添加一下，如图：


同时，在工程上添加一个新的Item时，你将会发现多了一个Item选项，这个就是AR的模版文件：


这里有必要解释下多出来的这2个咚咚是干嘛的。

1， 工具箱里的那个Viewer，是放在Form上的，可以理解为一个容器。

2， 那个新Item，是个rpx文件，是AR的模版，可以理解为需要放到容器里的实物。最终用户通过Form上的那个Viewer容器，看到AR模版的内容。

 

二，创建一个AR报表的简单流程。

a)         创建一个窗体frmShowAR，在这个form上add一个 Viewer控件Viewer1。

b)        创建一个AR模版ARSimpleExample

c)        AR模版ARSimpleExample随便加几个textbox（工具箱里多了个ActiveReports板块，只有里面的这些控件，才可以放到AR模版上），这就是我们需要打印出来的东西

d)        在窗体frmShowAR中加入代码，使Viewer1显示AR模版ARSimpleExample

 

    ''' -----------------------------------------------------------------------------
    ''' <summary>
    ''' form load事件
    ''' </summary>
    ''' <param name="sender"></param>
    ''' <param name="e"></param>
    ''' <remarks>
    ''' form load時，把AR模版裝載到Viewer容器中去
    ''' </remarks>
    ''' <history>
    '''     [TonyGong]    6/5/2006    Created
    ''' </history>
    ''' -----------------------------------------------------------------------------
    Private Sub frmShowAR_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        Try
            '創建AR模版實例
            Dim rpt As New ARSimpleExample

            '顯示AR模版
            Me.Viewer1.Document = rpt.Document
            rpt.Run()

        Catch ex As Exception
            MessageBox.Show(ex.ToString)
        End Try
    End Sub

e)         最后，运行程序，我们的第一张AR报表就这么诞生了。

 

 

这只是一个最最简单的例子，AR的功能还是很强大的，比如可以以dataset为数据源，设置AR模版；可以把报表导出成html，xls，pdf等。

整个AR的精华其实都在AR模版上，你们在AR模版上右击，view code，将发现AR模版其实是由一个.rpx文件和一个.vb文件（c#为.cs）组成的，这类似于asp.net中的代码分离技术，画面和代码分离。

在.vb文件中，你可以做很多控制，比如，画面（.rpx）上面有个显示日期的textbox控件，然后你可以在.vb中用代码获取当前日期，然后显示到.rpx上的控件中去。

这些内容，下篇再讲，今天先说到这里吧，希望能和大家一起探讨，共同进步。

本节代码下载:http://files.cnblogs.com/batoosai/SimpleExample.rar