在Winform开发中使用FastReport建立报表

FastReport.Net是一款适用于Windows Forms, ASP.NET和MVC框架的功能齐全的报表分析解决方案。可用在Microsoft Visual Studio 2005到2015，支持.Net Framework 2.0到4.x。我下载了一个FastReport进行测试使用，这个报表功能仍是很强大的。

对其中FastReport的一些功能，我编写整理了一个小小的案例进行介绍，进行了简单的测试记录，但愿对了解FastReport的使用有帮助。案例界面功能以下所示。

一、FastReport的汉化处理

默认安装FastReport提供多语言的资源，咱们能够在程序运行的时候指定对应的语言位置和文件便可。

实现中文化界面的代码以下所示

            string baseDir = Path.Combine(Application.StartupPath, "Examples/TestFastReport");
            FastReport.Utils.Res.LocaleFolder = Path.Combine(baseDir, "L18N");
            var file = FastReport.Utils.Res.LocaleFolder + @"Chinese (Simplified).frl";
            FastReport.Utils.Res.LoadLocale(file);

这样咱们在运行界面后，就能够看到FastReport的汉化界面了。

 

二、FastReport打印预览

默认加入FastReport的控件，包含几个主要的界面控件，以下所示。

其中PeviewControl就是预览报表的控件，而DesignerControl则是设计报表的控件，咱们这里介绍PeviewControl控件用来显示报表。

首先咱们在一个空白的窗体界面上拖动一个PreviewControl进行报表的处理，以下界面所示。

剩下的就是如何展现报表内容了。

加载报表的设计文件代码以下所示。

            //加载报表设计文件
            this.Report = new FastReport.Report();
            var reportFile = Path.Combine(baseDir, "Report/Simple List.frx");
            this.Report.Load(reportFile);
            this.Report.Preview = this.previewControl1;

而报表设计界面加载完毕后，还须要指定报表的数据源，以便总体渲染呈现报表的内容，实现的代码以下所示。

            DataSet ds = new DataSet();
            var dataFile = Path.Combine(baseDir, "Report/nwind.xml");
            ds.ReadXml(dataFile);
            Report.RegisterData(ds, "NorthWind");

            Report.Prepare();
            Report.ShowPrepared();

运行界面，就能够获得下面的报表界面效果。

 

整个报表支持不少其余类型的操做，如条形码、二维码、图表、图片等内容的展现，具体能够参考其官方案例的界面。

 

三、FastReport打印设计

上面介绍了 FastReport的PreviewControl，其设计控件DesignerControl的用法相似，不过这个控件是用来设计修改报表文件的，咱们处理的代码以下所示。

加载报表设计文件代码以下。

            this.Report = new FastReport.Report();
            var reportFile = Path.Combine(baseDir, "Report/Simple List.frx");
            this.Report.Load(reportFile);

若是报表须要加载数据进行显示，那么须要加载报表数据。

            DataSet ds = new DataSet();
            var dataFile = Path.Combine(baseDir, "Report/nwind.xml");
            ds.ReadXml(dataFile);
            Report.RegisterData(ds, "NorthWind");

            this.designerControl1.Report = this.Report;
            Report.Prepare();
            Report.Design();

运行界面，能够获得运行效果以下所示。

 

四、FastReport导出PDF

FastReport的另外一个场景是能够不须要界面展现，直接经过设计文件，实现PDF文件的导出处理，实现界面代码以下所示。

        private void btnPDFReport_Click(object sender, EventArgs e)
        {
            Report report = new Report();
            var reportFile = Path.Combine(baseDir, "Report/Simple List.frx");
            report.Load(reportFile);

            //准备数据
            DataSet ds = new DataSet();
            var dataFile = Path.Combine(baseDir, "Report/nwind.xml");
            ds.ReadXml(dataFile);
            report.RegisterData(ds, "NorthWind");

            //运行报表
            report.Prepare();

            //导出PDF报表
            var file = FileDialogHelper.SavePdf("result.pdf");
            if (!string.IsNullOrEmpty(file))
            {
                PDFExport export = new PDFExport();
                report.Export(export, file);
            }
            report.Dispose();

            if(File.Exists(file))
            {
                Process.Start(file);
            }
        }

这个部分没有报表展现，直接导出的PDF并存储，若是须要打开则能够看到报表的PDF文件以下所示。

 

 

五、FastReport使用实体业务对象生成报表

在个人Winform开发框架里面，主要采用的数据都是实体类对象数据。FastReport报表里面除了标准的DataSet数据源外，确定也会支持实体类数据，这种实体类的业务对象数据也是使用很普遍的。

    private void btnRunExisting_Click(object sender, EventArgs e)
    {
      // 建立报表并加载设计文件
      Report report = new Report();
      report.Load(Path.Combine(baseDir, "Report/report.frx"));

      //注册业务对象数据
      report.RegisterData(FBusinessObject, "Categories");

      //运行报表
      report.Show();
      report.Dispose();
    }

其中的数据对象初始化代码以下所示。

    private void CreateBusinessObject()
    {
      FBusinessObject = new List<Category>();

      Category category = new Category("Beverages", "Soft drinks, coffees, teas, beers");
      category.Products.Add(new Product("Chai", 18m));
      category.Products.Add(new Product("Chang", 19m));
      category.Products.Add(new Product("Ipoh coffee", 46m));
      FBusinessObject.Add(category);

      category = new Category("Confections", "Desserts, candies, and sweet breads");
      category.Products.Add(new Product("Chocolade", 12.75m));
      category.Products.Add(new Product("Scottish Longbreads", 12.5m));
      category.Products.Add(new Product("Tarte au sucre", 49.3m));
      FBusinessObject.Add(category);

      category = new Category("Seafood", "Seaweed and fish");
      category.Products.Add(new Product("Boston Crab Meat", 18.4m));
      category.Products.Add(new Product("Red caviar", 15m));
      FBusinessObject.Add(category);
    }

从上面咱们能够看到，数据源是一个实体类集合的列表，从而展现如何使用这些数据源构造报表，运行界面效果以下所示。

 

FastReport的功能很强大，其设计文件是独立的，所以能够对报表设计文件进行修改调整，从而实现客户端的维护处理，它的功能也是很强大，支持在报表中添加文本、图像、线条、形状、语句、条形码、矩阵、表格、RTF、选择框等，列表报表、分组报表、主从报表、多列报表等内容。

在Winform开发中，咱们也可使用XtraReport报表和RDLC报表引擎，这方面能够参考我以前的随笔文章《DevExpress的XtraReport和微软RDLC报表的使用和对比》 和《会员管理系统的设计和开发（2）-- RDLC报表的设计及动态加载》进行了解，感谢你们对博客的支持。