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，值也很相似，但属于不同类型，在运算时如果没有转化，会出错。