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# 全选

        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.frx");

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

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

Sql数据源

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

C# 全选

        private void SqlDemo()
        {
            var report = new Report();
            var reportFile = Path.Combine(Application.StartupPath, "demo.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;

            //获取DataTable数据源
            var dtDemo = DemoData.GetTable("tb_SO");

            //注册数据源
            report.RegisterData(dtDemo, "tb_SO");
            report.Load(reportFile);
            var ok = report.Design(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);
        }