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

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