ActiveReports 9实战教程（2）：准备数据源（设计时、运行时）

时间 2019-11-06

标签 activereports 实战教程准备数据设计运行时繁體版

原文原文链接

在上讲中《ActiveReports 9实战教程（1）：手把手搭建环境Visual Studio 2013 社区版》，咱们已经结合Visual Studio 2013搭建好了ActiveReports 9的开发环境，并完成了一个Hello World的RDL报表。在本文，咱们经过配置数据源进行报表实战，作过报表开发的报表达人知道，报表中的数据源分设计时数据源和运行时数据源。如何理解呢？html

这2类数据源，表结构是同样的，用途不同：程序员

1 设计时数据源，用于研发内部、报表小组进行配置、测试报表用。数据库

2 运行时数据源，用于系统割接后在局方现场运行报表系统，如修改连接数据库的字符串。函数

从上面2点可看出，设计时数据源的运行比较广：配置报表、测试、运行报表。而运行时数据库切换数据库连接字符串便可无缝实现数据源在用户现场部署，相对比较容易。post

下面用NWind_CHS.mdb数据源进行实战(AR9安装后，自带的数据源‪C:\Users\rogerwang\Documents\ComponentOne Samples\ActiveReports 9\Data\NWIND.mdb)。测试

设计时数据源

经过“视图--其余窗口--报表资源管理器 V9”，而后基于上讲的RdlReport1.rdlx文件，双击rdlx文件。spa

右键，添加数据源设计

在新建立的数据源DataSource1，右键添加数据集。code

在弹出的添加数据集中，有2种办法添加数据。orm

方法一：直接写SQL。这种方式适合程序员、SQL比较强的人，效率高。

方法二：经过AR9新提供的VQD进行（可视化查询设计器）。这种方法适合产品经理、需求分析师等对技术不细究的人，灵活。

这里重点说一下方法二：VQD。

可视化查询设计器(VQD)包含如下关键特性：

过滤数据
使用自定义表达式
从数据库选择字段
分组和合计函数
使用内链接，左外链接和右外链接
设置已选字段和数据表的别名
数据排序和更多特性

生成的SQL语句：

select Products.*, Categories.* from Products inner join Categories on Products.CategoryID = Categories.CategoryID

如分别拖动Description、ProductID到报表，预览结果：

至此，完成了运行时数据源的添加，AR提供的配置数据源功能，很是灵活和方便，可有效的提升报表开发效率。

运行时数据源

咱们在设计时配置的数据源，若是要迁移到用户现场，则须要能够动态修改数据源以适配用户的数据源环境。

可经过代码实现数据源切换（备注：数据库表结构是如出一辙的）

private void 运行时数据源区域报表ToolStripMenuItem_Click(object sender, EventArgs e)
    {
        SectionReport_DataSource_RunTime sReport1 = new SectionReport_DataSource_RunTime();
        sReport1.DataSource = GetDataSource();
        sReport1.Run();
        viewer1.Document = sReport1.Document;
    }    private DataTable GetDataSource()
    {
        DataTable dt = new DataTable();
        dt.Columns.Add("产品编号");
        dt.Columns.Add("产品名称");
        dt.Columns.Add("单价");
        dt.Columns.Add("库存量");
        dt.Rows.Add("A10002", "苹果", 20, 50);
        dt.Rows.Add("A15681", "香蕉", 20, 50);
        dt.Rows.Add("A15681", "菠萝", 20, 50);            
        return dt;
    }

在运行时经过 DataSource 属性设置数据源

private void 运行时数据源页面报表ToolStripMenuItem_Click(object sender, EventArgs e)
    {
        GrapeCity.ActiveReports.PageReport pReport1 = new GrapeCity.ActiveReports.PageReport(new System.IO.FileInfo("PageReport_DataSource_RunTime.rdlx"));
        viewer1.LoadDocument(pReport1.Document);            
    }    private void Form1_Load(object sender, EventArgs e)
    {
        viewer1.LocateDataSource += new GrapeCity.ActiveReports.LocateDataSourceEventHandler(viewer1_LocateDataSource);
    }    void viewer1_LocateDataSource(object sender, GrapeCity.ActiveReports.LocateDataSourceEventArgs args)
    {        if (args.DataSourceName == "DataSource1")
        {            if (args.DataSetName == "DataSet1")
            {
                args.Data = GetDataSource();
            }
        }
    }    private DataTable GetDataSource()
    {
        DataTable dt = new DataTable();
        dt.Columns.Add("产品编号");
        dt.Columns.Add("产品名称");
        dt.Columns.Add("单价");
        dt.Columns.Add("库存量");
        dt.Rows.Add("A10002", "苹果", 20, 50);
        dt.Rows.Add("A15681", "香蕉", 20, 50);
        dt.Rows.Add("A15681", "菠萝", 20, 50);        return dt;
    }

在运行时经过 LocateDataSource 事件加载数据源。

最后，顺便说一下：ActiveReport 能够和多种数据源交互，包括OLEDB, SQL, XML,Oracle、Sybase、Informix、SQL Server等。

参考的官方博客：

----------------------------------------------------------------------------------------------------------

ActiveReports 9实战教程目录：

ActiveReports 9实战教程（2）： 准备数据源（设计时、运行时）

设计时数据源

运行时数据源

ActiveReports 9实战教程（2）：准备数据源（设计时、运行时）