ASP.NET Web開發框架之三 報表開發

Enterprise Solution Web部分目前只實現了對RDLC的支持。實現一種報表格式的支持，需要做一些基礎的工作以便於與系統緊密的集成。

 

綁定數據源

首先看一下，我們在要報表中使用RDLC報表，經過設計報表文件，添加報表控件，然后我們需要增加下面的代碼，來綁定數據到報表中，以查看數據。

//綁定報表
reportViewer.LocalReport.ReportPath = MapPath( "SalesReport.rdlc");            
//綁定數據源  dataset1必須和你報表所引用的table 一致
reportDataSource rds = new ReportDataSource("SalesOrder", ds.Table[0]);
reportViewer.LocalReport.DataSources.Add(rds);
reportViewer.LocalReport.Refresh();

這個過程，每做一個新報表，都需要用此方法，給報表綁定數據。

Enterprise Solution系統因為知道數據源的位置，因為在數據庫注冊的地方，有注冊所此用的數據庫

其次，如何取數據呢，再參看報表定義文件中的內容，關鍵部分如下所示

 <DataSet Name="DataSet1">
      <Fields>
        <Field Name="USERID">
          <DataField>USERID</DataField>
          <rd:TypeName>System.String</rd:TypeName>
        </Field>
        <Field Name="USER_NAME">
          <DataField>USER_NAME</DataField>
          <rd:TypeName>System.String</rd:TypeName>
        </Field>
 <rd:DataSetInfo>   
        <rd:TableName>ADUSER</rd:TableName>
......

關鍵點也在此處，借助於Linq to xml，我可以解析成如下的SQL語句

SELECT USERID,USER_NAME FROM ADUSER

把這個結果，用微軟企業數據訪問庫，返回給報表，如下代碼所示

foreach (DataTable table in dataset.Tables)
{
     DataTable tbl = SqlHelper.ExecuteDataset(connectionString, CommandType.Text, sqls  [table.TableName]).Tables[0];

       foreach (DataRow oRow in tbl.Rows)
                table.ImportRow(oRow);
}

就達到了，報表自動取值的目的。這是通用的方法，可以簡化大量的C#報表編碼工作，像此段落開頭的那段代碼，現在完全可以省略。

 

多語言配置

其次，報表界面中的標簽，一般為靜態的標簽，無法與軟件系統的界面相匹配，造成打印出來的報表，報表語言可能與用戶的偏號不一致。到目前為止，我了解到的兩種方案，一各是，在界面要用到文本標簽的地方，引用外部的資源字符串，再根據程序的Culture來返回不同的字符串資源，關鍵的設置點是引用外部字符串資源程序集

如果您想了解更多，可參考關鍵字"Using Custom .NET Code with Reports”找到更多相關內容。

第二種方法，也是我到更為合理的辦法。報表定義文件本身是XML格式的，在報表呈現之前，可以把報表中的標簽文本，替換成適當的字符串語言資源。關鍵部分的代碼，看起來是這樣的

TextReader  rdl=null;
using(FileStream fileStream = File.OpenRead(path))
{
MemoryStream memStream = new MemoryStream();
memStream.SetLength(fileStream.Length);
fileStream.Read(memStream.GetBuffer(), 0, (int)fileStream.Length);
            
//多國語言處理   2表示簡體中文
Foundation.Common.LanguageTranslator.LanguageCode = 2;
rdl = ReportRenderHelper.Localize(fileStream);
}

reportViewer.LocalReport.LoadReportDefinition(rdl);
reportViewer.LocalReport.Refresh();

因為RDLC/RDL報表支持從一個TextReader中加載報表，不一定非要從硬盤報表文件中加載報表，在此，可以做相關的語言轉化工作。

 

多版本支持

第三，不管是哪種類型的報表，發展到到目前為止，均出現了多種不同的版本。客戶的服務器也可能會是不同版本的Server系統。微軟的組件兼容性好，但同時，也有很霸道的地方。比如，Visual Studio 2012明確只支持Windows 7及以上的OS，SQL Server 2012不再支持SQL Server 2000格式的數據庫。對於這里要用到的ReportViewer控件，對於SQL Server 2012，並沒有出對應的新版本的控件，所以，如果要瀏覽Report Builder 3 for SQL Server 2012設計出來的RDLC報表，呈現此報表的控件，仍然是SQL Server 2008版本的組件，如下版本所示

<%@ Register Assembly="Microsoft.ReportViewer.WebForms, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
    Namespace="Microsoft.Reporting.WebForms" TagPrefix="rsweb" %>

再以Crystal Report為例子，它的runtime就有好多個版本，同一個版本又有x86和x64的區別

最新版本的是for visual studio 2010, 主版本號13。這么多runtime要能同時支持，只有用反射，根據客戶端安裝的版本，來創建不同版本的runtime對象。或是以簡單的方法，規定要用指定版本的runtime，其它的則不支持。

例子代碼如下所示，可供您參考實現

Assembly engineAssembly = Assembly.Load(GetLongAssemblyName("CrystalDecisions.CrystalReports.Engine", version));
Assembly sharedAssembly = Assembly.Load(GetLongAssemblyName("CrystalDecisions.Shared", version));
Type printingConverterType = engineAssembly.GetType("CrystalDecisions.CrystalReports.Engine.PrintingConverter");

 

動態參數支持

RDLC不支持parameter，RDL才支持。微軟對此的解釋是，RDLC在取數時，要進行參數化處理，取出來的數據，是經過參數過濾的。RDL支持參數，傳遞參數時，使用像這樣的代碼片段

ReportParameter[] parm = new ReportParameter[1];
parm[0] = new ReportParameter("deptno", txtDeptno.Text);
reportViewer.ShowCredentialPrompts = false;
reportViewer.ProcessingMode = Microsoft.Reporting.WebForms.ProcessingMode.Remote;
reportViewer.ServerReport.ReportServerUrl = new System.Uri("http://localhost/ReportServer");
reportViewer.ServerReport.ReportPath = "/EnterpriseSolution/SalesOrder";
reportViewer.ServerReport.SetParameters(parm);
reportViewer.ServerReport.Refresh();

參數處理的奧妙，如下圖所示，在報表對話框中設計參數，運行時會動態創建控件，供用戶輸入值，再由運行時，將此值傳遞到報表中，達到簡化編碼的目的，經過這樣處理，同樣，不需要編寫任何C#代碼而達到傳遞參數值的目的。

字段格式，是最終要傳化為參數的格式，數據類型表示控件要使用的樣式。對於類型轉化，微軟提供了這樣的方法

object obj = ReflectionHelper.GetPropertyValue(control, targetProperty);
object converted = Convert.ChangeType(obj, type);
ReflectionHelper.SetPropertyValue(entity, arr[1], converted);

用文字來描述這段代碼的含義。以TextBox為例子，第一句取到TextBox的Text屬性，它是個字符串，如果type要求是的數字，則第二句把它轉化為字符串，第三句則應用反射將值傳遞給報表對象。在Visual Studio調試時，字符串有雙引號，數字則沒有，雖然看起來它們都是object，值也很相似，但屬於不同類型，在運算時如果沒有轉化，會出錯。