在月前發(fā)布的FastReport.Net2013.3中出現(xiàn)的FastReport.Service.dll引起了一些開發(fā)者的注意，今天我們就來談?wù)勥@個用于新的定制服務(wù)的WCF服務(wù)庫。

　　該庫中包含了以下功能：

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

　　List<ReportItem> GetReportsList()：返回一個可用的報(bào)表列表。每一個項(xiàng)目都被認(rèn)為是一個ReportItem對象，報(bào)表存儲在運(yùn)行該服務(wù)的服務(wù)器硬盤上，并按字母順序排序。

 　　List<ReportItem> GetReportsListByPath(string path)：按路徑返回可用的報(bào)表列表。

　　List<GearItem> GetGearList()：返回一個可用的格式列表，這些格式可以作為元素GearItem合并為服務(wù)報(bào)表。

　　Stream GetReport(ReportItem report, GearItem gear)：返回一個創(chuàng)建報(bào)表結(jié)果的流。

ReportItem

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

　　Path：路徑在服務(wù)器上，在相對的根文件夾內(nèi)存儲報(bào)表。該報(bào)表的文件擴(kuò)展名必須為*.frx，這個屬性一般被用來在下一步查詢中識別報(bào)表。

　　Name：元數(shù)據(jù)報(bào)表的名稱。如果元數(shù)據(jù)報(bào)表包含的是一個空的名字，那該屬性就只包含一個沒有擴(kuò)展名的文件名。這個屬性可以用于在應(yīng)用程序中創(chuàng)建一個交互式的列報(bào)表，如列表框等。

　　Description：元數(shù)據(jù)報(bào)表的報(bào)表描述。

　　Dictionary<string, string> Parameters：報(bào)表參數(shù)的字典，支持支持字符串值。

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：報(bào)表參數(shù)的字典。

　　需要注意是的，在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：用于指定報(bào)表文件夾的路徑。

　　FastReport.ConnectionStringName：指定數(shù)據(jù)庫連接流的名稱。

　　FastReport.Gear：可用格式列表。

FastReport.Service工作流程

確定接收報(bào)表和格式的流程

　　使用這個服務(wù)創(chuàng)建報(bào)表模板時，需要注意：

1. 報(bào)表中不支持對話框
2. 每個報(bào)表必須包括內(nèi)部的DataConnection