FastReport.NET2023报表数据源配置详解-开发框架文库

FastReport.NET2023报表数据源配置详解

FastReport.NET-开发框架文库

一、FastReport.NET简介

FastReport.Net是一款适用于Windows Forms, ASP.NET和MVC框架的功能齐全的报表分析解决方案。可用在Microsoft Visual Studio 2005到2019，支持.Net Framework 2.0到4.x，.NET Core。

使用FastReport.Net，您能创建独立于应用程序的报表。也就是说，FastReport.Net能作为一款独立的报表工具进行运用。

二、本文要点

FastReport.Net组件支持给前端实施工程师快速自定义报表，包括新增报表、修改报表格式等操作，而不需要编写任何代码。

三、配置报表数据源

Json数据源

逻辑：将List<T>实体对象转换为json文件，报表加载json文件作为数据源。

C# 全选

        /// <summary>
        /// Demo：本地文件json数据源
        /// </summary>
        private void JsonDemo()
        {
            //生成一个本地json文件
            var json = Newtonsoft.Json.JsonConvert.SerializeObject(DemoData.demoDataItems);
            var jsonFile = Path.Combine(Application.StartupPath, "demo.json");
            File.WriteAllText(jsonFile, json, System.Text.Encoding.UTF8);

            //加载报表模板文件
            var reportFile = Path.Combine(Application.StartupPath, "demo-json.frx");

            //生成报表数据源
            RegisteredObjects.AddConnection(typeof(JsonDataConnection));
            JsonDataConnection connection = new JsonDataConnection();
            connection.ConnectionString = "Json=" + jsonFile;
            connection.CreateAllTables();

            Report report = new Report();
            report.Dictionary.Connections.Add(connection);

            //注册数据源
            report.RegisterData(connection.DataSet);
            report.Load(reportFile);

            if (chkIsDesigner.Checked)
            {
                report.Design(true);//打开设计器
            }
            else
            {
                report.Show(true);//预览报表
            }
        }

Sql数据源，DataTable数据源

逻辑：注册DataSet/DataTable实体对象作为报表的数据源

C# 全选

        /// <summary>
        /// Demo:1、设置报表数据源连接，2、传入DataTable作为报表的数据源
        /// </summary>
        private void DataTableDemo(DataTable dtDemo)
        {
            var report = new Report();
            var reportFile = Path.Combine(Application.StartupPath, "demo-datatable.frx");

            //生成报表数据源
            RegisteredObjects.AddConnection(typeof(MsSqlDataConnection));
            MsSqlDataConnection connection = new MsSqlDataConnection();
            connection.ConnectionString = DemoData.connectionString;
            report.Dictionary.Connections.Add(connection);

            //设置报表设计器的数据源
            FastReport.EnvironmentSettings settings = new FastReport.EnvironmentSettings();
            settings.DesignerSettings.ApplicationConnection = new System.Data.SqlClient.SqlConnection();
            settings.DesignerSettings.ApplicationConnection.ConnectionString = DemoData.connectionString;
            Config.DesignerSettings = settings.DesignerSettings;

            report.Load(reportFile);

            //注册数据源                        
            report.RegisterData(dtDemo, "listSO");
            var ds = report.GetDataSource("listSO");
            (report.GetDataSource("listSO") as TableDataSource).Enabled = true; //重要

            //给DataBand(主表数据)绑定数据源
            DataBand masterBand = report.FindObject("Data1") as DataBand;
            masterBand.DataSource = report.GetDataSource("listSO"); //主表

            if (chkIsDesigner.Checked)
            {
                report.Design(true);//打开设计器
            }
            else
            {
                report.Show(true);//预览报表
            }
        }

List<T>实体对象数据源

C# 全选

        /// <summary>
        /// Demo:1、设置报表数据源连接，2、传入实体对象列表作为数据源
        /// </summary>
        /// <param name="listData"></param>
        private void DataListDemo(List<tb_SO> listData)
        {
            var report = new Report();
            var reportFile = Path.Combine(Application.StartupPath, "demo-list.frx");

            //生成报表数据源
            RegisteredObjects.AddConnection(typeof(MsSqlDataConnection));
            MsSqlDataConnection connection = new MsSqlDataConnection();
            connection.ConnectionString = DemoData.connectionString;
            report.Dictionary.Connections.Add(connection);

            //设置报表设计器的数据源
            FastReport.EnvironmentSettings settings = new FastReport.EnvironmentSettings();
            settings.DesignerSettings.ApplicationConnection = new System.Data.SqlClient.SqlConnection();
            settings.DesignerSettings.ApplicationConnection.ConnectionString = DemoData.connectionString;
            Config.DesignerSettings = settings.DesignerSettings;

            report.Load(reportFile);

            //注册数据源            
            report.RegisterData(listData, "listSO");
            //var ds = report.GetDataSource("listSO");
            //(report.GetDataSource("listSO") as BusinessObjectDataSource).Enabled = true; //重要

            if (chkIsDesigner.Checked)
            {
                report.Design(true);//打开设计器
            }
            else
            {
                report.Show(true);//预览报表
            }
        }

四、设计器定制各种报表数据源

选择数据源

FastReport.NET2023报表数据源配置详解

如果注册了数据库连接(如SqlConnection)，可以选择整个数据库的表作为报表数据源：

FastReport.NET2023报表数据源配置详解

Sql命令、存储过程自定义数据源

FastReport.NET2023报表数据源配置详解

或：

FastReport.NET2023报表数据源配置详解

设计新报表

FastReport.NET2023报表数据源配置详解

预览报表

FastReport.NET2023报表数据源配置详解

五、使用带参数的自定义查询Demo

必要条件：

1、给报表实例绑定Sql数据源。

2、给查询条件参数赋值。

优点：实施人员可设计自定义报表，不需要程序硬编码。

加载报表、设置报表连接、设置参数值

C# 全选

        /// <summary>
        /// Sql数据源报表，参数传值
        /// </summary>
        private void SqlDataSourceDemo()
        {
            var report = new Report();
            var reportFile = Path.Combine(Application.StartupPath, "demo-销售订单-by参数.frx");
            report.Load(reportFile);
            report.SetParameterValue("CustomerCode", "DS01");//给参数赋值

            //报表环境
            FastReport.EnvironmentSettings settings = new FastReport.EnvironmentSettings();
            settings.DesignerSettings.ApplicationConnection = new System.Data.SqlClient.SqlConnection();
            settings.DesignerSettings.ApplicationConnection.ConnectionString = DemoData.connectionString;//连接字符串
            Config.DesignerSettings = settings.DesignerSettings;

            report.Design(true);
            report.Show(true);
        }