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

FastReport.Net是一款适用于Windows Forms, ASP.NET和MVC框架的功能齐全的报表分析解决方案。可用在Microsoft Visual Studio 2005到2015，支持.Net Framework 2.0到4.x。我下载了一个FastReport进行测试使用，这个报表功能还是很强大的。
对其中FastReport的一些功能，我编写整理了一个小小的案例进行介绍，进行了简单的测试记录，希望对了解FastReport的使用有帮助。案例界面功能如下所示。

1、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的汉化界面了。

2、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();

运行界面，就可以得到下面的报表界面效果。

整个报表支持很多其他类型的操作，如条形码、二维码、图表、图片等内容的展示，具体可以参考其官方案例的界面。

3、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();

运行界面，可以得到运行效果如下所示。

4、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文件如下所示。

5、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 = 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报表的设计及动态加载》进行了解，感谢大家对博客的支持。