目錄

介紹

先決條件

戰(zhàn)略

使用代碼

以終為始

故事的其余部分

從RDLC文件中獲取查詢

設(shè)置任何參數(shù)

重構(gòu)

報(bào)表參數(shù)/查詢參數(shù)

網(wǎng)址參數(shù)

運(yùn)行查詢并填寫數(shù)據(jù)表

跟進(jìn)（重構(gòu)）

更新：導(dǎo)致錯(cuò)誤的其他事情

結(jié)論

---

• 下載 VStudio 2010 的舊源 - 21.2 KB? 或
• 下載 VStudio 2013 的源代碼?- 179.6 KB

?

這是一個(gè)常見的場(chǎng)景：您有一個(gè)用ASP.NET（或MVC或SharePoint）編寫的網(wǎng)站，并且您想顯示一些報(bào)告。您可能正計(jì)劃編寫一些新報(bào)告，并且您正在嘗試決定使用哪種技術(shù)，或者您可能有幾個(gè)之前已經(jīng)制作的SSRS報(bào)告，并且您希望從您的ASP.NET站點(diǎn)運(yùn)行它們。

CodeProject上有很多很好的文章，展示了如何使用RDLC文件運(yùn)行報(bào)表，無論是來自ASP.NET還是WinForms等。閱讀它們之后，您的選擇似乎是：

將報(bào)表放入SSRS并使用ReportViewer控件調(diào)用SSRS運(yùn)行您的報(bào)表

將.RDL或.RDLC文件添加到您的項(xiàng)目中，并創(chuàng)建一些對(duì)象來存放數(shù)據(jù)，以便報(bào)表具有與數(shù)據(jù)庫的接口，我想要第三種選擇：

只需像SSRS一樣運(yùn)行它，但無需安裝SSRS服務(wù)器。我說的是最低限度的足跡。我只想將.RDL或.RDLC文件的名稱傳遞給ASPX頁面并讓它運(yùn)行。這就是SSRS的做法。我應(yīng)該也能做到。

這是第三種選擇的實(shí)現(xiàn)。

先決條件

要運(yùn)行它，您仍然需要安裝報(bào)告運(yùn)行時(shí)。您可以將其添加為Nuget包“Microsoft.ReportViewer.Runtime.Common”和“Microsoft.ReportViewer.WebForms”（或WinForms）。Microsoft 下載站點(diǎn)上提供了可再發(fā)行組件。

我有一些舊報(bào)告，它們是用舊的商業(yè)智能開發(fā)工作室(2008)制作的。我還有一些使用ReportBuilder（內(nèi)置SSRS網(wǎng)絡(luò)）制作的新報(bào)告。此解決方案適用于任何一個(gè)。

戰(zhàn)略

.RDLC文件都是XML?。如果您使用記事本打開它并檢查內(nèi)容，您會(huì)看到XML描述了顯示/設(shè)計(jì)，但它還包含其他一些有用的特征。其中之一是報(bào)表的查詢（獲取數(shù)據(jù)）。

我的策略是提取數(shù)據(jù)庫查詢，設(shè)置任何參數(shù)，運(yùn)行查詢，將結(jié)果存儲(chǔ)在DataTable(s)中并將其提供給報(bào)告。

我的目標(biāo)是從通用頁面運(yùn)行我的報(bào)告，并通過URL QueryString傳遞報(bào)告名稱和任何查詢參數(shù)，如下所示：

.../View.aspx?Report=Example.rdlc&StartDate=1/1/2012&EndDate=12/31/2012

為簡(jiǎn)單起見，我將只使用應(yīng)用程序其余部分使用的相同DB連接字符串，但我會(huì)將其包裝在本地工廠方法中，以實(shí)現(xiàn)可維護(hù)性。

使用代碼

以終為始

這就是我開始的地方。這些示例效果很好，但無法使用嵌入在報(bào)告中的查詢。在代碼塊（如下）中，您可以看到我創(chuàng)建了一個(gè)名為Report?(命名空間是RDL)的類來封裝RDLC的內(nèi)容/結(jié)構(gòu)。我的RDL.Report類還包含一個(gè)工廠方法來幫助將XML轉(zhuǎn)換為對(duì)象。

//View.aspx.cs protected void ShowReport() {System.IO.FileInfo reportFullPath = this.ReportFile;//check to make sure the file ACTUALLY exists, before we start working on itif (reportFullPath != null){//map the reporting engine to the .rdl/.rdlc filervReportViewer.LocalReport.ReportPath = reportFullPath.FullName; // 1. Clear Report DatarvReportViewer.LocalReport.DataSources.Clear();// 2. Get the data for the report// Look-up the DB query in the "DataSets" // element of the report file (.rdl/.rdlc which contains XML)RDL.ReportreportDef = RDL.Report.GetReportFromFile(reportFullPath.FullName);// Run each query (usually, there is only one) and attach it to the reportforeach (RDL.DataSet ds in reportDef.DataSets){//copy the parameters from the QueryString into the ReportParameters definitions (objects)ds.AssignParameters(this.ReportParameters);//run the query to get real data for the reportSystem.Data.DataTable tbl = ds.GetDataTable(this.DBConnectionString);//attach the data/table to the Report's dataset(s), by nameReportDataSource rds = new ReportDataSource();rds.Name = ds.Name; //This refers to the dataset name in the RDLC filerds.Value = tbl;rvReportViewer.LocalReport.DataSources.Add(rds);}rvReportViewer.LocalReport.Refresh();} }

故事的其余部分

（上面的）代碼塊顯示了應(yīng)用程序的核心；運(yùn)行查詢并將數(shù)據(jù)附加到報(bào)表，然后運(yùn)行報(bào)表。現(xiàn)在，讓我們看看獲取數(shù)據(jù)的部分。

從RDLC文件中獲取查詢

在.RDLC文件中，查詢的XML如下所示（刪除其他所有內(nèi)容后）：

<Report><DataSets><DataSet Name="IrrelevantToThisExample"><Query><DataSourceName>DataTableName</DataSourceName><CommandText>SELECT * FROM sys.Tables</CommandText></Query></DataSet></DataSets> </Report>

在我的第一次嘗試中，我使用XPath從XML（在RDLC文件內(nèi)部）中提取查詢。它適用于簡(jiǎn)單的查詢。但是，我意識(shí)到如果查詢有任何參數(shù)（或存儲(chǔ)過程等），事情就會(huì)變得一團(tuán)糟。

在我的第二次嘗試中，我采取了不同的方法。我意識(shí)到如果我將XML反序列化為一堆對(duì)象，代碼會(huì)更容易。這聽起來既復(fù)雜又可怕，但是一旦你看到它，你就會(huì)意識(shí)到XML序列化/反序列化是多么簡(jiǎn)單。

與此XML匹配的（簡(jiǎn)化的）類如下所示：

[Serializable(), System.Xml.Serialization.XmlRoot("Report")] public class Report : SerializableBase {public List<DataSet> DataSets = new List<DataSet>(); }public class DataSet {[System.Xml.Serialization.XmlAttribute]public string Name;public Query Query = new Query(); }public class Query {public string DataSourceName;public string CommandText; }

反序列化XML后，您可以輕松提取查詢，如下所示：

Report report =Report.Deserialize(xml, typeof(RDL.Report)); String commandText = report.DataSets[0].Query.CommandText;

該SerializableBase對(duì)象是我從幾個(gè)項(xiàng)目中重復(fù)使用的東西。它使將任何對(duì)象序列化或反序列化為XML變得簡(jiǎn)單，反之亦然。這是代碼：

[Serializable] public class SerializableBase {public static SerializableBase Deserialize(String xml, Type type){//… some code omitted for brevity. See downloads.System.Xml.Serialization.XmlSerializer ser = new System.Xml.Serialization.XmlSerializer(type);using (System.IO.StringReadersr = new System.IO.StringReader(xml)){return (SerializableBase)ser.Deserialize(sr);}} }

設(shè)置任何參數(shù)

正如我前面提到的，在我處理參數(shù)化查詢和存儲(chǔ)過程之前，代碼非常簡(jiǎn)單。我不得不添加更多的反序列化類。為簡(jiǎn)潔起見，我會(huì)將它們包含在下載的代碼中，但可以免去您在此處閱讀代碼的麻煩。別擔(dān)心。它們是非常簡(jiǎn)單（無聊）的類，與XML的結(jié)構(gòu)相匹配，就像上面的序列化類一樣。

重構(gòu)

此代碼的其余部分從實(shí)用程序類開始。看完之后，我意識(shí)到如果我將實(shí)用程序代碼封裝在序列化類中作為方法而不是作為外部輔助實(shí)用程序函數(shù)，那將更加純粹地面向?qū)ο蟆Ｋ剐蛄谢惪雌饋砀鼜?fù)雜。這就是為什么在本文中，我首先以最簡(jiǎn)單的形式描述原始類（如上）。

報(bào)表參數(shù)/查詢參數(shù)

不幸的是，在RDLC文件中，查詢塊定義了它的參數(shù)，但沒有為它們定義類型。DB會(huì)阻塞不容易轉(zhuǎn)換的類型，例如：DateTime、Numeric和Integer。幸運(yùn)的是，參數(shù)類型在RDLC的XML的單獨(dú)部分中定義。我只需要將它們復(fù)制到查詢參數(shù)定義中。不幸的是，它使代碼看起來有點(diǎn)老套，但它確實(shí)可靠地完成了工作。

//Report.cs private void ResolveParameterTypes() {//for each report parameter, find the matching query parameter and copy-in the data typeforeach (ReportParameter rParam in this.ReportParameters){foreach (DataSet ds in this.DataSets)foreach (QueryParameter qParam in ds.Query.QueryParameters){if (qParam.Value == "=Parameters!" + rParam.Name + ".Value"){qParam.DataType = rParam.DataType;}}} } // override the constructor so the report param types are always resolved to the query params //as a bonus, now you don't have to cast it after deserializing it public static Report Deserialize(string xml, Type type) {Report re;re = (Report)SerializableBase.Deserialize(xml, type);//copy the type-names from the ReportParameters to the QueryParametersre.ResolveParameterTypes();return re; }

網(wǎng)址參數(shù)

現(xiàn)在，我將(URL)QueryString中的參數(shù)復(fù)制到報(bào)告的param中。自然，我對(duì)與報(bào)告中的QueryString參數(shù)名稱匹配的參數(shù)名稱做出了一些重大假設(shè)。如果它們不匹配，則會(huì)出現(xiàn)錯(cuò)誤，但應(yīng)該很容易找出問題所在。我還可以添加一些診斷程序來檢測(cè)哪些參數(shù)沒有獲得分配給它們的值（可能稍后）。

//View.aspx.cs private System.Collections.Hashtable ReportParameters {get{System.Collections.Hashtable re = new System.Collections.Hashtable();//gather any params so they can be passed to the reportforeach (string key in Request.QueryString.AllKeys){if (key.ToLower() != "path")//ignore the "path" param. It describes the report’s file path{re.Add(key, Request.QueryString[key]);}}return re;} }//DataSet.cs public void AssignParameters(System.Collections.HashtablewebParameters) {foreach (RDL.QueryParameter param in this.Query.QueryParameters){string paramName = param.Name.Replace("@", "");//if this report param was passed as an arg to the report, then populate itif (webParameters[paramName] != null)param.Value = webParameters[paramName].ToString();} }

運(yùn)行查詢并填寫數(shù)據(jù)表

這是很基本的。設(shè)置命令對(duì)象，添加參數(shù)，然后只需使用DataAdapter來填充表格。

//DataSet.cs public System.Data.DataTable GetDataTable(string DBConnectionString) {System.Data.DataTable re = new System.Data.DataTable();using (System.Data.OleDb.OleDbDataAdapter da = new System.Data.OleDb.OleDbDataAdapter(this.Query.CommandText, DBConnectionString)){if (this.Query.QueryParameters.Count > 0){foreach (RDL.QueryParameter param in this.Query.QueryParameters){string paramName = param.Name.Replace("@", "");//OLEDB chokes on the @symbol, it prefers ? marksusing (System.Data.OleDb.OleDbCommand cmd = da.SelectCommand)cmd.CommandText = cmd.CommandText.Replace(param.Name, "?");using (System.Data.OleDb.OleDbParameterCollection params = da.SelectCommand.Parameters)switch (param.DataType){case "Text":params.Add(new OleDbParameter(paramName, OleDbType.VarWChar) { Value = param.Value });break;case "Boolean":params.Add(new OleDbParameter(paramName, OleDbType.Boolean) { Value = param.Value });break;case "DateTime":params.Add(new OleDbParameter(paramName, OleDbType.Date) { Value = param.Value });break;case "Integer":params.Add(new OleDbParameter(paramName, OleDbType.Integer) { Value = param.Value });break;case "Float":params.Add(new OleDbParameter(paramName, OleDbType.Decimal) { Value = param.Value });break;default:params.Add(new OleDbParameter(paramName, param.Value));break;}}}da.fill(re);re.TableName = this.Name;return re; }

跟進(jìn)（重構(gòu)）

我確實(shí)重構(gòu)了這段代碼（在下載中），這使它有點(diǎn)混亂。我想讓它變得靈活，這樣我就可以在多個(gè)項(xiàng)目中使用它。由于我無法確定db連接字符串將始終是OLEDB或SqlClient連接，因此我檢查了連接字符串并為其中任何一個(gè)使用了適當(dāng)?shù)膸旒?/span>(OLEDB/SQLClient)。代碼長(zhǎng)度增加了一倍，但更便攜。

更新：導(dǎo)致錯(cuò)誤的其他事情

一位朋友幫我運(yùn)行了一些測(cè)試報(bào)告，結(jié)果表明如果出現(xiàn)問題，該ReportViewer控件不會(huì)生成任何好的/有用的錯(cuò)誤消息。相比之下，我放在View頁面的“Download”按鈕，在處理過程中很容易報(bào)錯(cuò)。從中，我學(xué)到了一些東西：

如果報(bào)表具有外部圖形或報(bào)表部件，則這些文件需要可用（也就是說，您也需要/reports文件夾中的這些文件）并且在正確的路徑中。對(duì)于我的測(cè)試示例，報(bào)告使用文件夾/Reports/Web Parts/中的圖形。

如果報(bào)告具有必需的參數(shù)（或不是“可選的”），則必須提供這些參數(shù)，否則報(bào)告將不會(huì)運(yùn)行。

參數(shù)可以區(qū)分大小寫。也許它只是.NET。無論哪種方式，如果您的報(bào)告無法運(yùn)行，請(qǐng)檢查以確保您提供的是“PrintID”或“PrintId”，而不僅僅是“printid”。

最后，我最近更新了這個(gè)示例以使用Visual Studio 2013運(yùn)行。我添加了一個(gè)“診斷”頁面，以檢查一些設(shè)置。我改進(jìn)了“下載”選項(xiàng)。我改進(jìn)了這個(gè)例子來處理外部圖像，并檢測(cè)所需的報(bào)告參數(shù)。

我希望你發(fā)現(xiàn)它對(duì)你更有效。如果沒有，我會(huì)很感激反饋，甚至可能是一個(gè)示例文件(.rdl)，這樣我就可以解決任何錯(cuò)誤。

結(jié)論

這就是從RDLC文件中提取查詢并在ASP.NET中運(yùn)行它所需的全部?jī)?nèi)容。

SSRS最初是由Microsoft編寫的，作為如何使用這些技術(shù)來完成我在此處展示的內(nèi)容的示例。當(dāng)然，SSRS的許多功能遠(yuǎn)遠(yuǎn)超出了我所展示的范圍，但如果您不需要所有這些豐富的功能，那么此代碼對(duì)于您和您的.NET項(xiàng)目來說應(yīng)該是快速且可移植的。

https://www.codeproject.com/Articles/607382/Running-a-RDL-RDLC-SQL-Report-in-ASP-NET-without-S

總結(jié)

以上是生活随笔為你收集整理的在没有SSRS的ASP.NET中运行RDL/RDLC（SQL报告）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。