WCF服務(wù)庫FastReport.Service.dll

FastReport .NET 包含庫 FastReport.Service.dll（僅在 .NET 4.0 包中）。該庫是 WCF 服務(wù)庫，旨在用于執(zhí)行服務(wù)功能的自定義應(yīng)用程序。

該庫包含以下函數(shù)：

List<ReportItem> GetReportsList();

返回可用報告的列表。每個項目都作為 ReportItem 對象返回。報告存儲在運行該服務(wù)的服務(wù)器的硬盤上。文件按字母順序排序。

List<ReportItem> GetReportsListByPath(string path);

List<GearItem> GetGearList();

Stream GetReport(ReportItem report, GearItem gear);

返回構(gòu)建報告的結(jié)果流。參數(shù)“report”和“gear”可以從先前獲得的列表中使用，或者通過創(chuàng)建具有所需屬性的新對象來使用。返回的流不支持定位。

讓我們看看列表元素。

報告項目

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

路徑 – 服務(wù)器上報告文件的路徑，相對于存儲報告的根文件夾。報告的文件擴展名必須是*.frx。該屬性用于識別具有進一步查詢的特定報告。

名稱 – 報告的名稱，取自報告的元數(shù)據(jù)。如果報告的元數(shù)據(jù)包含空名稱，則該屬性包含不帶擴展名的文件名。此屬性可用于在應(yīng)用程序中構(gòu)建可用報告的交互式列表（例如：在列表框中）。

描述 – 報告的描述，取自報告的元數(shù)據(jù)。

Dictionary<string, string> 參數(shù) – 報表參數(shù)字典，可以是填充參數(shù)，隨后將傳輸?shù)?報表中。它僅支持設(shè)計報告模板時必須考慮的字符串值。

裝備物品

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

名稱 – 格式名稱：可能包含以下字符串之一：

Dictionary<string, string> 屬性 – 報告參數(shù)的字典。請求服務(wù)器列出格式時，可以獲得帶有默認值的受支持參數(shù)的完整列表。

創(chuàng)建服務(wù)時，您必須在 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 – 指定包含報告的文件夾的路徑，其中的列表將傳輸?shù)娇蛻舳恕?/span>FastReport.ConnectionStringName – 數(shù)據(jù)庫的連接字符串名稱，存儲在配置節(jié)中。用于替換報告模板中的內(nèi)部連接字符串。

FastReport.Gear – 可用格式列表。您可以僅選擇所需的名稱并更改名稱的順序。

FastReport.Service使用示意圖：

而且，如果您已經(jīng)確切知道要報告的內(nèi)容以及以哪種格式接收報告（這會減少對服務(wù)的查詢數(shù)量）：

創(chuàng)建在服務(wù)中使用的報告模板時需要注意的要點：

• 報告中的對話框不受支持，將被忽略；

• 每個報表必須包含一個內(nèi)部 DataConnection，其報表服務(wù)的連接字符串將替換為配置中的字符串。

FastReport.Service.dll 的使用示例可以在文件夾 \Demos\C#\WCFWebService 、 \Demos\C#\WCFWindowsService 、 \Demos\C#\WCFWebClient 、 \Demos\C#\WCFClient 中找到。

示例配置文件服務(wù) - FastReport.Service.dll.config。