ASP.NET之WEB项目中水晶报表的使用

由于接手一个项目,主要是报表输出时表格头比较复杂,又要打基础印,所以想到了水晶报表:

以上做以标记:

在我们对VS.Net中的水晶报表(Crystal Reports)进行研究之前,我和我朋友对如何将这个复杂的东东加入我们的Web应用有着非常的好奇心。一周以后,在阅读了大量的“HOWTO”文档之后,我们成功地将一些简单的报告加入到了我们的Asp.net程序中,并得到了一些小决窍。
  这篇文章教你如何在.Net Web应用中使用水晶报表,也可以让你在学习过程中少走一些弯路。为了得到最好的效果,读者最好需要有一些基础的Asp.Net访问数据库的知识以及使用VS.Net的开发经验。
  简介
  水晶报表可以由很多的方法得到,其中一个就是使用VS.Net来创建,它提供了非常丰富模型以使我们能够在运行时操作属性和方法。如果你正在使用VS.Net开发.Net程序,那么你就不需要再安装其它软件了,因为他已经内嵌在VS.Net中了。
  优点:
  VS.Net水晶报表有下面一些主要的优点:
快速的报表开发
能够导出成为复杂的交互性图表
可以与其它控件一起在WebForm中使用
能够动态地将报表导出成为.pdf,.doc,xls,html,rtf等多种格式
  结构:
  一些组件组成了水晶报表的二层结构,需要的Web应用有:
  客户端 :
  客户端仅需要一个可以访问嵌入aspx页面报表的游览器就可以了
  服务器 :
  水晶报表引擎(Crystal Report Engine (CREngine.dll))
  通过它可以完成一些任务,如在报告文件中合并数据,转换报告为其它格式等。也正是因为报告引擎的作用,才可以将Asp.Net中的水晶报表转换成为普通HTML格式
  水晶报表设计器(Crystal Report Designer (CRDesigner.dll))
  水晶报表就是在设计器中创建的,在设计器中你可以设计标题,插入数据,公式,图表,子报表等。
  .rpt报表文件
  执行报表中的第一步就是在水晶报表设计器接口创建此报表,在默认安装中微软已经提供了一些现成的.rpt例子。
  Data Source
  .rpt文件取得数据库的方法取决于你方法的选择,你能选择让水晶报表自己选择数据而不使用任何代码或者也可以选择手动的组装DataSet,然后再将其传送到报表文件。
  水晶报表查看控件(Crystal Report Viewer web form Control (CRWebFormViewer.dll))
  水晶报表查看控件是一个WebForm控件,可以将它看成是一个在.aspx页面中存放报表的容器。 注意:在一些复杂的操作中,报表服务器与Web服务器可能不在同一物理主机上,Web服务器将HTTP请求传送到报表服务器上去。水晶报表也可以当做WebService来执行。
  执行模式
  水晶报表取数据可以使用下面的方法实现:
  Pull 模式:
  被请求时,水晶报表直接根据指定的驱动连接数据库然后组装这些数据。
  Push 模式 :
  此时开发表不得不自己编写代码连接数据并组装DataSet,同时将它传送至报表。在些这种情况下,通过使用连接共享以及限制记录集合的大小,可以使用报表性能最大化。
  报表类型:
  水晶报表设计器能够直接包含报表至工程也能够使用独立的报表对象。
  Strongly-typed 报表 :
  当你将报表文件加入到项目中去时,它就变成了一个了“ strongly-typed“报表。在这些情况下,你将拥有直接创建报表的对象的权力,这将减少一些代码并且能够提供一些性能。
  Un-Typed 报表 :
  这里的报表并不直接包含在项目中,因此称为‘un-typed’ 报表。在这种情况下,你不得不使用水晶报表的”ReportDocuemt“对象建立一个实例,并且”手动“地凋用报表。
  其它注意事项
  尽管水晶报表查看器拥有一些很酷的功能,如缩放、页面导航等。但是他不提供打印功能,你不得不调用游览器的打印功能。
  VS.Net中的水晶报表如果没有注册,那么它只能使用30次,30次后,”保存“功能就不能再使用了。为了避免这个,你不是不在 http://www.crystaldecisions.com/这里注册此产品。 (好像不是这样子的,不注册也好像能用很长的时间,只是不能提供支持)
  默认安装的水晶报表只能支持5个用户,为了支持更多的用户,你不得不在 http://www.crystaldecisions.com/中购买许可证。
让我们感受一下----在Asp.net中使用一个现成的水晶报表文件

  让我们先感受一下在WebForm中使用水晶报表的感觉。   
1) 从WebForm工具栏中拖动水晶报表查看器控件(Crystal Report Viewer)至.aspx页面中。
  2) 调出水晶报表查看器控件的属性窗口  
  3) 点击[...]按钮查看"Data Binding"属性,并弹出了DataBinding窗口。
  4) 从左边的"Bindable属性”区中选择“Report Source”
  5) 选中"自定义绑定表达式"单选按钮,在右边的底部的窗口中指定.rpt文件的文件名和路径,例如:"C://Program Files//Microsoft Visual Studio.NET//Crystal Reports//Samples//Reports//General Business//World Sales Report.rpt",然后”确定“

  注意:文件”World Sales Report.rpt“文件是在VS.Net安装时创建的。如果你在安装过程中指定了其它目录,此时你最好确认一下路径的正确性。
  上面的步骤中实际上是插入了下面这些代码至Asp.Net文件中:
<%@ Register TagPrefix="cr" Namespace="CrystalDecisions.Web" Assembly="CrystalDecisions.Web" %>
  以及:<CR:CrystalReportViewer id=shuijingreport style="Z-INDEX: 102; LEFT: 152px; POSITION: absolute; TOP: 112px" runat="server" Width="966px" Height="977px" ReportSource='<%# "D://Program Files//Microsoft Visual Studio .NET 2003//Crystal Reports//Samples//Reports//General Business//World Sales Report.rpt" %>' SelectionFormula="{Customer.去年销售额}>0">
   </CR:CrystalReportViewer>
   注意:在飞刀我的VS.Net正式版中自动生成的代码中ReportSource产生的样式不是这样子的,它是: ReportSource=" <%# C:/xxxxx/xxx.rpt %>"
  这样是错误的,会出现错误信息,有两处错误:
DataBind中要有双引号,因此外部只能用单引号
目录分隔符号不能使用"/",必须使用"//"
  必须按照使用本文介绍的格式来手动修改,这也算是VS.Net的一个Bug吧。
  6) 在Page_Load方法中调用DataBind方法。
C#
private void Page_Load(object sender, System.EventArgs e)
  {
   // 在此处放置用户代码以初始化页面
   DataBind();
  }
VB.Net
Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)
DataBind()
End Sub
  7)保存并编译你的页面。 现在,你就有一个内嵌水晶报表的WebForm页面了。
  注意:实际开发中,一开始会出现无法访问inetsrv目录的错误,解决的办法是改变其目录的安全属性,使User用户有可写的权限。飞刀我发现.Net系统自已给出的解决方法是没有用的,也可能是我使用的是Windows.Net操作系统的原因。 

 

关于登录失败的处理:

 

大家在基于webform中使用水晶报表时如果简单的按照网上“阿刀”的做法,肯定会提示你:登陆失败。
对于这个问题,斑竹我花了整整一天的时间研究水晶报表的帮助文件,终于得到解决方案。
我不是一个保守的人,我相信有很多的网友正和我一样在花费精力在研究这个问题,我不愿意大家再和我一样白白的花费精力。
下面是我实现该方案的几个步骤。大家不要着急,慢慢的看下去会对你有很大的帮助。
步骤一:看示例文件
水晶报表自带一个示例文件,数据库是access(不带密码的)。我首先运行示例文件(基于webform和winform)结果显示了正确的报表,正如“飞刀”的示例。
于是,我自己建立了一个报表文件和.aspx文件,结果显示登陆失败!可是我把报表文件换成示例的报表文件,不再出错。
问题出在什么地方?难道是报表格式文件有关于登陆权限的设置?通过跟踪、调试,我对比分析我的报表文件和示例报表文件,没有发现任何的不同。看来问题不在报表文件。
是数据库的问题?我建立一个access结果还是登陆失败!
不是数据库的问题(我自己的数据库是未带密码的access,帮助中的数据库也是如此)?也不是报表格式文件的问题(我仔细分析了两者的原代码是相同的)?
那么问题出现在什么地方?我白思不得其解!
步骤二:找帮助文件
于是我再次求助于帮助。我翻遍了水晶报表的帮助,终于找到“ 访问安全数据库 [C#]”字样,发现这里有下面的一段话:
通过 Crystal Reports for Visual Studio .NET 访问安全数据库的过程在 Web 窗体和 Windows 窗体之间有所不同。在 Windows 窗体中,对话框自动提示用户输入用户名和密码(测试很容易成功)。而在 Web 窗体中,您需要设计一个表单以从用户获取该信息。对于这两种情况,均可使用代码来指定用户名和密码,从而为应用程序的所有用户提供相同的安全等级。

于是我对同样的数据库(先是用帮助示例中的access数据库,后来用自己建立的access数据库)。发现对于同一个报表文件,对于winform能显示成功,而对于webform则仍然显示登陆失败!于是我有点明白上面的意思!
看来问题是出在权限的设置上。

步骤三:研究帮助,终于成功!
在帮助里我找到“设置数据库登录参数”字样,里面提供了一些后来发现是非常有用的信息:
下列示例说明如何将登录参数传递到报表的表中。该示例使用到某个安全的 SQL Server 数据库的连接。 

启动一个新项目 
向窗体添加一个“按钮”和四个“文本框”控件。 
将“文本框”控件分别命名为:serverNameTxt、dbNameTxt、userNameTxt 和 passwordTxt。 
双击“按钮”控件以指定 Click 事件的代码。根据所用语言插入适当的代码。
[C#] 
// 声明所需变量。
TableLogOnInfo logOnInfo = new TableLogOnInfo ();
int i = 0;

// 对报表中的每个表依次循环。
for (i=0;i == Report.Database.Tables.Count - 1;i++)
{
// 设置当前表的连接信息。
logOnInfo.ConnectionInfo.ServerName = serverNameTxt.Text;
logOnInfo.ConnectionInfo.DatabaseName = dbNameTxt.Text;
logOnInfo.ConnectionInfo.UserID = userNameTxt.Text;
logOnInfo.ConnectionInfo.Password = passwordTxt.Text;
Report.Database.Tables [i].ApplyLogOnInfo (logOnInfo);
}
注意 受密码保护的 Microsoft Access 和 Paradox 等 PC 数据库也使用该方法,但 LogOnInfo.ServerName 和 LogOnInfo.DatabaseName 要保留为空。
于是我仿照这个样子,尝试了一下,出错提示:没有发现TableLogOnInfo 和Report。
后来我发现TableLogOnInfo 是属于CrystalDecisions.Shared 命名空间的成员。于是我添加引用:
using CrystalDecisions.Shared ;
这次问题出现在Report。
Report?这是个什么东西,我查遍了所有的帮助,并没有这个函数或类!
[说真的!这个问题难到了我很长的时间!一直在查找Report到底是个什么东西!水景报表公司也真是的,帮助也不写得详细一点!该打!!!]
最终我终于发现Report只是一个用户定义的对象,不是系统本身的对象。
在我困惑的时候,突然我想,为什么不看看Report后面的DataBase,这是个什么东西,终于问题解决了,在帮助里找到如下信息
ReportDocument oRpt = new ReportDocument();
Report属于DocumentCrystalDecisions.CrystalReports .Engine 类的成员。
修改代码:并添加引用
using CrystalDecisions.Shared ;//负责解释TableLogOnInfo类
using CrystalDecisions.CrystalReports .Engine ;//负责解释ReportDocument类private void Page_Load(object sender, System.EventArgs e)
{
TableLogOnInfo logOnInfo = new TableLogOnInfo ();
//这里必须事先申明一个ReportDocument对象 Report,同时加载数据报表
ReportDocument oRpt = new ReportDocument();
oRpt.Load("c://inetpub//wwwroot//exer//pagelet//crystal//cr1.rpt");//修改为你自//己的正确位置

//建立安全信息
//受密码保护的 Microsoft Access 和 Paradox 等 PC 数据库也使用该方法,但 LogOnInfo.ServerName //和 LogOnInfo.DatabaseName 要保留为空
logOnInfo.ConnectionInfo.ServerName = "www";
logOnInfo.ConnectionInfo.DatabaseName = "archives";
logOnInfo.ConnectionInfo.UserID = "sa";
logOnInfo.ConnectionInfo.Password = "123456";

oRpt.Database .Tables [0].ApplyLogOnInfo (logOnInfo);

//建立.rpt文件与CryStalReportviewer文件之间的连接
CrystalReportViewer1.ReportSource = oRpt;
}
报表文件终于出现!
哇,我好高兴,禁不住站起来伸了个懒腰!

步骤四:最终的完整版的代码
上面的代码不具有系统可扩充和灵活性。缺点有二:
(1)、数据报表格式文件是采用绝对路径
(2)、数据库访问权限的设置一旦设定,在最终发布是无法修改的,特别是客户的SQL SERVER服务器不可能和你调试的程序环境是一样的
基于这个考虑。引进两个比较好的东西:
(1)、Server.Mappath函数
(2)、读取web.config(本示例同时告诉你如何操作web.config配置文件)
最终修改如下:(完整代码)数据库为sql server2000
using CrystalDecisions.Shared ;//负责解释TableLogOnInfo类
using CrystalDecisions.CrystalReports .Engine ;//负责解释ReportDocument类

private void Page_Load(object sender, System.EventArgs e)
{
TableLogOnInfo logOnInfo = new TableLogOnInfo ();
//这里必须事先申明一个ReportDocument对象 Report,同时加载数据报表
ReportDocument oRpt = new ReportDocument();
//获取.rpt文件真实路径
string path1,path2;
path1=Server.MapPath ("//exer//pagelet");
path2=path1+"//crystal//cr1.rpt";
//oRpt.Load("c://inetpub//wwwroot//exer//pagelet//crystal//cr1.rpt");
oRpt.Load (path2);

//从web.config中获取logOnInfo参数信息
string a,b,c,d;
//获取ServerName
a=System.Configuration .ConfigurationSettings .AppSettings ["servername"];
//获取DatabaseName
b=System.Configuration .ConfigurationSettings .AppSettings ["database"];
//获取UserId
c=System.Configuration .ConfigurationSettings .AppSettings ["userid"];
//获取password
d=System.Configuration .ConfigurationSettings .AppSettings ["pass"];
//设置logOnInfo参数
logOnInfo.ConnectionInfo.ServerName = a;
logOnInfo.ConnectionInfo.DatabaseName = b;
logOnInfo.ConnectionInfo.UserID = c;
logOnInfo.ConnectionInfo.Password = d;

oRpt.Database .Tables [0].ApplyLogOnInfo (logOnInfo);

//建立.rpt文件与CryStalReportviewer文件之间的连接
CrystalReportViewer1.ReportSource = oRpt;
}


整个演示的操作过程说明:
1、 在解决方案资源管理器里,你需要存放报表文件处,添加新项:CrystalReport报表,起名为cr1.rpt
2、 在随后出现的“报表专家”中选择数据源时,请务必选择OLE DB,然后根据你的数据库的要求选择响应的驱动引擎:
SQL SERVER:Microsoft OLE DB Provider for SQL server
Access:Microsoft Jet.4.0
3、 输入正确的数据库连接,这一步大家一般的情况下不会出错!
4、 建立数据报表,并保存cr1.rpt文件
5、 打开webform1.aspx。添加crystalreportviewer控件:名称为:CrystalReportViewer1
6、 在webform1.aspx.cs中的page_load事件中添加上面的代码:
(注意:引用千万不要忘了!)


*****************************************************
下面是web.config中与本内容有关的细节
<appSettings>
<add key="servername" value="www"/>
<add key="database" value="archives"/>
<add key="userid" value="admin"/>
<add key="pass" value="123456"/>
</appSettings>


***注意这里的<add key="pass" value="123456"/>是pass,所以他必须与
//获取password
d=System.Configuration .ConfigurationSettings .AppSettings ["pass"];这里
的AppSettings["pass"] 中的"pass"保持一致。 当然名字是可以随便起,但必须一致 

©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页