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 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开发中使用FastReport创建报表,如需转载请自行联系原博主。