报表控件FastReport使用指南——使用NuGet包创建PDF文档

「爱情、让人受尽委屈。」 2023-10-10 22:52 81阅读 0赞

[FastReport][] 是功能齐全的报表控件，可以帮助开发者可以快速并高效地为.NET，VCL，COM，ActiveX应用程序添加报表支持，由于其独特的编程原则，现在已经成为了Delphi平台最优秀的报表控件，支持将编程开发中的报表信息输出为TXT、PDF等多种文件格式，是编程开发人员必备的报表工具。

[FastReport .Net][]是一款全功能的Windows Forms、ASP.NET和MVC报表分析解决方案，使用FastReport .Net可以创建独立于应用程序的.NET报表。

[FastReport.NET官方版下载(qun:585577353)![icon-default.png_t_N4N7][]https://www.evget.com/product/1861/download][FastReport.NET_qun_585577353_icon-default.png_t_N4N7_https_www.evget.com_product_1861_download]

在[上篇文章][Link 1]中，我们学习了如何使用FastReport .NET在Ubuntu 22.04.1 LTS系统中的.JetBrains Rider上创建PDF文档。本次将分享FastReport .NET 在 JetBrains Rider 中工作的最简单方法——使用 Fast Reports 中的私有 NuGet 服务器。

因此，本文主要描述在购买[FastReport .NET][]后如何添加NuGet包，从而在Ubuntu 22.04.1 LTS系统中的.NET IDE上创建、构建和导出PDF报告/文档的过程。

单击IDE底部的NuGet选项卡，然后单击Sources选项卡。

![b57a737f00e4efa13948fb9aaab20bd8.png][]

现在通过点击“+”来添加一个新的存储库，并输入必要的数据:

\- Name—不带空格的源名称(例如FastReport);  
\- URL—https://nuget.fast-report.com/api/v3/index.json;  
\- User—来自Fast Reports帐户的电子邮箱;  
\- Password—来自Fast Reports帐户的密码。

![3ded10b2e4db8bf1ffb1e8dfd89036d1.png][]

您将看到存储库:

![68ce4d702f10b418ddaeb5946fac033f.png][]

现在我们将安装FastReport Core 包。为此，请转到“Packages”选项卡并通过FastReport存储库过滤包。然后，安装找到的包。

![d6a67d7d8aefcfb3519a18ce42aa3850.png][]

安装成功，您将收到通知。

![15766dd4d9efbe2c532f357f92f9fd27.png][]

接下来，从代码中创建一个模板，为此我们将执行以下操作：添加到Program.cs:

>     using System.Drawing;
>     using FastReport;
>     using FastReport.Export.Pdf;
>     using FastReport.Utils;

接下来，将 CreateDataSet 添加到下面的 Program.cs 中：

>     Report report = new Report();
>     CreateReportTemplate();
>     ExportToPDF();

然后，添加创建报表模板函数CreateReportTemplate：

>     void CreateReportTemplate()
>     {
>     // adding a report page
>     ReportPage page = new ReportPage();
>     
>     // creating a date band
>     DataBand data = new DataBand();
>     PageHeaderBand dataText = new PageHeaderBand();
>     
>     //creating a header
>     ReportTitleBand titleBand = new ReportTitleBand();
>     TextObject employeeIdText = new TextObject();
>     TextObject employeeNameText = new TextObject();
>     TextObject idText = new TextObject();
>     TextObject nameText = new TextObject();
>     TextObject titleText = new TextObject();
>     //registering the data source
>     report.RegisterData(dataSet);
>     //enabling on the data table
>     report.GetDataSource("Employees").Enabled = true;
>     //adding a page to the template
>     report.Pages.Add(page);
>     // add to the page: data,data Text, titleBand
>     // and set the unique name of the page
>     page.AddChild(data);
>     page.AddChild(dataText);
>     page.AddChild(titleBand);
>     page.CreateUniqueName();
>     // set the unique name titleBand
>     // and set the band settings
>     titleBand.CreateUniqueName();
>     titleBand.Height = Units.Centimeters * 1.5f;
>     titleText.Bounds = new RectangleF(300, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     titleText.Text = "Employees";
>     titleText.Font = new Font("Arial", 14, FontStyle.Bold);
>     titleText.VertAlign = VertAlign.Center;
>     
>     // set the unique name data
>     // and set the data settings
>     data.CreateUniqueName();
>     data.DataSource = report.GetDataSource("Employees");
>     data.Height = Units.Centimeters * 0.5f;
>     
>     // set a unique dataText name
>     // and set the dataText settings
>     dataText.CreateUniqueName();
>     dataText.Height = Units.Centimeters * 0.8f;
>     
>     // setting the unique name employeeIdText
>     // and set the employeeIdText, idText settings
>     employeeIdText.Parent = data;
>     employeeIdText.CreateUniqueName();
>     employeeIdText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     idText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     idText.Text = "ID";
>     employeeIdText.Text = "[Employees.ID]";
>     
>     // set the unique name employeeNameText
>     // and set the employeeNameText, nameText settings
>     employeeNameText.Parent = data;
>     employeeNameText.CreateUniqueName();
>     employeeNameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     nameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     nameText.Text = "Name";
>     employeeNameText.Text = "[Employees.Name]";
>     
>     // add on data band: employeeIdText, employeeNameText
>     data.AddChild(employeeIdText);
>     data.AddChild(employeeNameText);
>     
>     // add on dataText band: idText, nameText
>     dataText.AddChild(idText);
>     dataText.AddChild(nameText);
>     
>     // add on titleBand band: itleText
>     titleBand.AddChild(titleText);
>     }

接下来，添加创建ExportToPDF报表模板的功能，并将报表导出命名为“Report.pdf”:

>     void ExportToPDF()
>     {
>     // running the report
>     report.Prepare();
>     // creating an export instance
>     PDFExport export = new PDFExport();
>     report.Export(export, "test.pdf");
>     // disposing the resources used by the report
>     report.Dispose();
>     }

最后，启动控制台应用程序。如果您收到响应 Process finished with exit code 0，那么您之前做的每一步，打开报告，在我们的例子中，它是路径:

*/home/alex/RiderProjects/ReportPDF\_Core\_ConsoleApp/ReportPDF\_Core\_ConsoleApp/bin/Debug/net6.0/test .pdf:*

![7c066d2984dcaaf8bce9654e663ccaca.png][]

由此，我们得到了一个从数据集构建的简单报表/PDF文档。

在本文中，我们讨论了绑定**JetBrains Rider (C\#) + .NET Core + Console Application + FastReport .NET Core + Linux (Ubuntu 22.04.1 LTS)** ，并从PDF数据集构建了一个报告。当然，我们确保.NET平台可以在没有Microsoft Visual Studio的情况下轻松使用，因为Linux根本没有它。

**完整的程序清单**

>     using System.Data;
>     using System.Drawing;
>     using FastReport;
>     using FastReport.Export.Pdf;
>     using FastReport.Utils;
>     
>     //creating a data set
>     DataSet dataSet = new DataSet();
>     CreateDataSet();
>     //creating a report
>     Report report = new Report();
>     
>     CreateReportTemplate();
>     ExportToPDF();
>     
>     void CreateReportTemplate()
>     {
>     // add a report page
>     ReportPage page = new ReportPage();
>     
>     // create a data band
>     DataBand data = new DataBand();
>     PageHeaderBand dataText = new PageHeaderBand();
>     
>     //create a title
>     ReportTitleBand titleBand = new ReportTitleBand();
>     TextObject employeeIdText = new TextObject();
>     TextObject employeeNameText = new TextObject();
>     TextObject idText = new TextObject();
>     TextObject nameText = new TextObject();
>     TextObject titleText = new TextObject();
>     //register a data source
>     report.RegisterData(dataSet);
>     //enable a data table
>     report.GetDataSource("Employees").Enabled = true;
>     //add a page to the template
>     report.Pages.Add(page);
>     //add on a page: data,dataText, titleBand
>     // and set the unique page name
>     page.AddChild(data);
>     page.AddChild(dataText);
>     page.AddChild(titleBand);
>     page.CreateUniqueName();
>     // set the unique name titleBand
>     // and set the band settings
>     titleBand.CreateUniqueName();
>     titleBand.Height = Units.Centimeters * 1.5f;
>     titleText.Bounds = new RectangleF(300, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     titleText.Text = "Employees";
>     titleText.Font = new Font("Arial", 14, FontStyle.Bold);
>     titleText.VertAlign = VertAlign.Center;
>     
>     // create the unique data name
>     // and set the data settings
>     data.CreateUniqueName();
>     data.DataSource = report.GetDataSource("Employees");
>     data.Height = Units.Centimeters * 0.5f;
>     
>     // create a unique dataText name
>     // and set dataText settings
>     dataText.CreateUniqueName();
>     dataText.Height = Units.Centimeters * 0.8f;
>     
>     // create the unique employeeIdText name
>     // and set the employeeIdText, idText settings
>     employeeIdText.Parent = data;
>     employeeIdText.CreateUniqueName();
>     employeeIdText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     idText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     idText.Text = "ID";
>     employeeIdText.Text = "[Employees.ID]";
>     
>     // create the unique name employeeNameText
>     // and set the employeeNameText, nameText settings
>     employeeNameText.Parent = data;
>     employeeNameText.CreateUniqueName();
>     employeeNameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     nameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
>     nameText.Text = "Name";
>     employeeNameText.Text = "[Employees.Name]";
>     
>     // and add on data band: employeeIdText, employeeNameText
>     data.AddChild(employeeIdText);
>     data.AddChild(employeeNameText);
>     
>     // add on dataText band: idText, nameText
>     dataText.AddChild(idText);
>     dataText.AddChild(nameText);
>     
>     // add on titleBand band: itleText
>     titleBand.AddChild(titleText);
>     }
>     
>     void ExportToPDF()
>     {
>     report.Prepare();
>     PDFExport export = new PDFExport();
>     report.Export(export, "test.pdf");
>     report.Dispose();
>     }
>     
>     void CreateDataSet()
>     {
>     // create a simple dataset with a single table
>     
>     // create a simple dataset
>     dataSet = new DataSet();
>     
>     // create a table
>     DataTable table = new DataTable();
>     table.TableName = "Employees";
>     // add the table to dataset
>     dataSet.Tables.Add(table);
>     
>     // add data to the table
>     table.Columns.Add("ID", typeof(int));
>     table.Columns.Add("Name", typeof(string));
>     table.Rows.Add(1, "Andrew Fuller");
>     table.Rows.Add(2, "Nancy Davolio");
>     table.Rows.Add(3, "Margaret Peacock");
>     }

以上就是本文全部内容，如果您有任何问题需了解详情，请评论或私聊我，欢迎大家加入官方社群互相交流~

[FastReport]: https://www.evget.com/vendor/106
[FastReport .Net]: https://www.evget.com/product/1861/lastly
[icon-default.png_t_N4N7]: https://csdnimg.cn/release/blog_editor_html/release2.2.9/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=N4N7
[FastReport.NET_qun_585577353_icon-default.png_t_N4N7_https_www.evget.com_product_1861_download]: https://www.evget.com/product/1861/download
[Link 1]: https://blog.csdn.net/m0_67129275/article/details/130884370
[FastReport .NET]: https://www.evget.com/product/1861/license
[b57a737f00e4efa13948fb9aaab20bd8.png]: https://img-blog.csdnimg.cn/img_convert/b57a737f00e4efa13948fb9aaab20bd8.png
[3ded10b2e4db8bf1ffb1e8dfd89036d1.png]: https://img-blog.csdnimg.cn/img_convert/3ded10b2e4db8bf1ffb1e8dfd89036d1.png
[68ce4d702f10b418ddaeb5946fac033f.png]: https://img-blog.csdnimg.cn/img_convert/68ce4d702f10b418ddaeb5946fac033f.png
[d6a67d7d8aefcfb3519a18ce42aa3850.png]: https://img-blog.csdnimg.cn/img_convert/d6a67d7d8aefcfb3519a18ce42aa3850.png
[15766dd4d9efbe2c532f357f92f9fd27.png]: https://img-blog.csdnimg.cn/img_convert/15766dd4d9efbe2c532f357f92f9fd27.png
[7c066d2984dcaaf8bce9654e663ccaca.png]: https://img-blog.csdnimg.cn/img_convert/7c066d2984dcaaf8bce9654e663ccaca.png