世俱杯 2025

　　在月前发布的FastReport.Net2013.3中出现的FastReport.Service.dll引起了一些开发者的注意，今天我们就来谈谈这个用于新的定制服务的WCF服务库。

　　该库中包含了以下功能：

List<ReportItem> GetReportsList();
List<ReportItem> GetReportsListByPath(string path);
List<GearItem> GetGearList();
Stream GetReport(ReportItem report, GearItem gear);

 　　List<ReportItem> GetReportsList()：返回一个可用的报表列表。每一个项目都被认为是一个ReportItem对象，报表存储在运行该服务的服务器硬盘上，并按字母顺序排序。

　　List<ReportItem> GetReportsListByPath(string path)：按路径返回可用的报表列表。

　　List&lt;GearItem> GetGearList()：返回一个可用的格式列表，这些格式可以作为元素GearItem合并为服务报表。

 　　Stream GetReport(ReportItem report, GearItem gear)：返回一个创建报表结果的流。

ReportItem

public class ReportItem
 {
 public string Path;
 public string Name;
 public string Description;
 public Dictionary<string, string> Parameters;
 }

　　Path：路径在服务器上，在相对的根文件夹内存储报表。该报表的文件扩展名必须为*.frx，这个属性一般被用来在下一步查询中识别报表。

　　Name：元数据报表的名称。如果元数据报表包含的是一个空的名字，那该属性就只包含一个没有扩展名的文件名。这个属性可以用于在应用程序中创建一个交互式的列报表，如列表框等。

　　Description：元数据报表的报表描述。

　　Dictionary<string, string> Parameters：报表参数的字典，支持支持字符串值。

GearItem

public class GearItem
 {
 public string Name;
 public Dictionary<string, string> Properties;
 }

　　Name：格式的名称，可能包含PDF、DOCX、XLSX、PPTX、RTF、ODS、ODT、MHT、CSV、DBF、XML、TXT、FPX等字符串。

　　Dictionary<string, string> Properties：报表参数的字典。

　　需要注意是的，在App.config或Web.config中需要添加以下几行代码：

<appSettings>
 <add key="FastReport.ReportsPath" value="C:\Program files\FastReports\FastReport.Net\Demos\WCF" />
 <add key="FastReport.ConnectionStringName" value="FastReportDemo" />
 <add key="FastReport.Gear" value="PDF,DOCX,XLSX,PPTX,RTF,ODS,ODT,MHT,CSV,DBF,XML,TXT,FPX" />
 </appSettings>

　　FastReport.ReportsPath：用于指定报表文件夹的路径。

　　FastReport.ConnectionStringName：指定数据库连接流的名称。

　　FastReport.Gear：可用格式列表。

FastReport.Service工作流程

确定接收报表和格式的流程

　　使用这个服务创建报表模板时，需要注意：

1. 报表中不支持对话框
2. 每个报表必须包括内部的DataConnection