XtraReports 使用说明
一 安装
Dxperience最新版本是Dxperience v8.33。安装完组件库之后,Dxperience中的控件会自动嵌入到 vs系统中。在创建报表等项目是并不需要添加引用,系统会自动为你添加需要的引用。
二 创建一个简单报表
我们以一个最简单的hello word例子开始。
首先打开vs2005,新建一个项目,点击项目右键添加一个新项,选择XtraReport Class v8.3(选择XtraReport Wizard v8.3通过向导创建),
点击确定,弹出提示框,
选择“是”,则新的报表文件将添加进入App_Code文件夹内,如果选择“否”,则直接添加进入项目中,会出现不能显示设计器的情况,所以建议选择“是”。这样一个新的报表文件添加进来了,但是一个报表文件是不能直接显示的,是要嵌入到页面中才能显示给客户,将一个报表文件加入到页面中其实很简单,只需要加入几句话就可以了,首先添加DevExpress.Web引用,然后新建一个页面,在页面的前台添加下面的引用:
<%@ Register Assembly=\"DevExpress.XtraReports.v8.3.Web, Version=8.3.3.0, Culture=neutral,
PublicKeyToken=b88d1754d700e49a\"
Namespace=\"DevExpress.XtraReports.Web\" TagPrefix=\"dxxr\" %>
在form标签中加入
runat=\"server\">
ID=\"ReportViewer\"
可以编辑报表显示的边框,尺寸等等。
在后台加入下面的程序:
protected void Page_Load(object sender, EventArgs e)
{
ReportViewer.Report = new XtraReport1();
}
这样报表就可以显示出来了,但是现在我们什么也看不到,因为报表中还没有添加任何内容。下面我们向报表中添加内容,达到我们想要的显示效果。
在初始的设计器中只有PageHeader、明细和页脚三个带区。
如果想要添加更多的块可以右键点击设计器的任何地方,弹出菜单,选择想要添加的带区,
除了Group Header以外每一个带区都只能出现在一个报表中一次。
控件:
当我们安装完XtraReports组件之后,在工具栏中就会自动加入报表控件组,我们常用到的是控件是XRLabel, XRTable。对于任何复杂报表,这些工具基本可以满足你的要求。首先我们将XRLabel拖拽到Detail带区。在属性窗口修改Text属性为“hello word”,修改Font属性,将字体放大些。搞定!我们的第一个报表程序完成了,就这么简单,不需要长长的代码和复杂的过程。从我们做的第一个简单的例子就可以看出,Dxperience的这个报表控件特点就是简单、易用,设计器清爽、美观。同时智能的创建向导也更加快捷使用。
三 连接数据源
上面我们只是创建非常简单的报表,对于连接数据源,创建复杂报表XtraReports也提供了非常好的解决办法。下面我们看看怎么样连接数据源,显示数据信息。XtraReports对于web项目中数据源的绑定不如winform项目灵活。我目前知道有两种方式,一种是:是通过项目中添加DataSet文件的形式,通过DataSet得到的数据源添加到报表的数据源
中。第二种是:通过后台编写代码实现数据绑定,如果还有其他方法,敬请赐教。
首先我们了解下第一种通过DataSet绑定数据源方式。
在当前项目中(最好是在报表文件所在的目录下)添加DataSet文件,则系统会弹出链接数据源的向导,
选择你的数据源,
点击【下一步】——>点击【下一步】——>点击【下一步】——>默认选中『Use SQL statemens』,点击【下一步】——>点击【Query Builder】.
弹出上面的对话框,这里可以编写sql语句了,点击【ok】,此时数据源产生了。下面
就是要将这个DataSet的数据源添加到报表中去。打开报表的设计视图,在工具栏的Data组中选择DataSet,将DataSet拖拽到设计器界面中,如图:
会弹出如图所示的界面,在Typed dataset中,选择刚刚创建的DataSet1,这样刚刚创建的DataSet数据源就添加到了报表文件中。此时你会发现在Field List窗口中多了一个dataset11,这个就是我们刚刚添加的数据源,将这些字段拖拽到我们报表的控件上,就达到了绑定数据源的目的,
现在我先介绍下后台代码的绑定数据源方式。
首先创建数据源,这里以SQL Server 2005为例,创建一个PersonInfo的表。
CREATE TABLE [dbo].[PersonInfo](
[id] [int] IDENTITY(1,1) NOT NULL, [name] [nvarchar](50),
[age] [int], [sex] [int], [wage] [decimal](8, 2))
数据创建完之后,然后创建一个的报表文件,在设计器示图下,从工具栏中拖拽一个XRTable,对XRTable的操作与html中的table一样。插入指定列。有些情况报表的带区是不需要的,我们只需在设计时将其删除,例如,这里我们把PageFooter删除了。
设计页面已经完成,下面就要指定报表的数据源。在想要嵌入报表的页面的后台中插入下面的代码:
protected void Page_Load(object sender, EventArgs e)
{
ReportViewer.Report = new XtraReport1();
DataSet ds = GetData();
ReportViewer.Report.DataSource = ds;
}
//使用ado.net连接数据源的普通代码,在此省略
protected DataSet GetData()
{
}
报表的数据源已经给定了,那么就要将数据与控件对应。在报表的代码页面加入下面的代码:
public XtraReport1()
{
InitializeComponent();
SetReportData();
}
/// /// 设置报表数据源
///
private void SetReportData()
{
this.xrTableCell1.DataBindings.Add(\"Text\", DataSource, \"id\");
this.xrTableCell2.DataBindings.Add(\"Text\", DataSource, \"name\");
this.xrTableCell3.DataBindings.Add(\"Text\", DataSource, \"sex\");
this.xrTableCell4.DataBindings.Add(\"Text\", DataSource, \"age\");
this.xrTableCell5.DataBindings.Add(\"Text\", DataSource, \"wage\");
}
大功告成,让我们看看效果吧!
但是感觉还有一些不足,时间戳,数据列没有名称,性别显示是0,1,工资字段没有汇总。下面我们一项一项解决这些问题。
注意:ReportHeader带区和PageHeader带区的区别,ReportHeader是显示报表的头部,只显示一次,与报表的页数无关,只在报表的第一页的头部显示;PageHeader
是页头显示,无论此报表多少页,每页都会显示PageHeader带区中的部分,ReportFooter和PageFooter与其道理相同,所以我们通常将大标题和时间戳放在ReportHeader,将列名称放在PageHeader内。每页汇总放在PageFooter,总汇总放在ReportFooter中,设计视图如图:
这里注意边框的调整,Detail带区中的Table的边框是没有上边框的,这样在列表显示时,不会因为边框重合而引起边框宽度增加。显示效果如图所示:
下面看看汇总的实现,汇总有总计,平均值,百分比,最大,最小等等,上例中我们实现的是对工资求总和,首先添加PageFooter带区,拖拽一个XRLabel设置Text为“工资总计:”,再拖拽一个XRLabel,点击summary属性的省略部分,会弹出如图所示部分:
这里可以设置绑定列,汇总函数类型,结果显示的字符串格式,是否忽略空值,汇总类型等。
这里的汇总类型有多种形式,有按组汇总,按页汇总,整个报表汇总。 汇总属性设置完毕,还要给这个控件绑定数据,在后台绑定其他控件的地方加上这句:
this.xrLabel3.DataBindings.Add(\"Text\", DataSource, \"wage\");
其他的汇总都是一样的!
差不多大功告成了,还有一些不足就是,性别显示是0或1,我们需要显示的是男和女,还不需要通过修改数据实现,那XtraReport可以实现吗?告诉你,是完全可以的!使用HtmlItemCreated事件,在性别列设置他的HtmlItemCreated事件,加入下面的代码:
if (e.ContentCell.InnerText == \"0\")
{
e.ContentCell.InnerText = \"女\";
}
else if (e.ContentCell.InnerText == \"1\")
{
e.ContentCell.InnerText = \"男\";
}
else {
e.ContentCell.InnerText = \" \";
}
显示如图所示:
可以了,报表终于完成了,开始打印了,哎!?怎么打印呢,忘了介绍了,现在我们将打印,预览,翻页等介绍一下。
在需要嵌入报表的页面的前台加入下面这句:
ReportViewer=\"<%# ReportViewer %>\" >
注意:其中ReportViewer是需要控制的报表的ID。这样,我们的报表就可以有打印,转化格式保存,翻页(还没有完成)的功能了。
数据如果太多了,我希望每页只显示3条数据怎么办?下面涉及到翻页了,虽然打印工具栏里有翻页功能,但是需要在报表里设置页数才能生效。首先声明变量:
int RecordCount = 0; //累加每页的记录数
写Detail的BeforePrint事件,写入下面的代码:
/// /// 实现每页下面打印多少条记录
///
private void Detail_BeforePrint(objectSystem.Drawing.Printing.PrintEventArgs e)
{
//实现每页下面打印多少条记录
RecordCount += 1;
if (RecordCount == 3) //每页打条记录
{
Detail.PageBreak = PageBreak.AfterBand;
RecordCount = 0;
}
sender,
else
{
Detail.PageBreak = PageBreak.None;
}
}
这样,就可以实现分页了,看看下面的效果:
剩下最后一步了,就是字体问题,XtraReport支持除宋体,仿宋之外的大部分字体,所以,我们要对报表控件的字体属性设置成支持的字体,否则,打印或者转化成pdf格式的文件都会将汉字转化成方格。至此,一张简单的数据报表完成了,绘制报表还有很多技巧是在使用中不断摸索出来的。工作愉快,共同进步。
问题:
目前存在的问题是:
1、Developer Express .Net 8.3.3版本不支持宋体和仿宋体字体,当汉字设置成宋体时,打印与生成pdf文件时,汉字会变成方格,生成其他格式或浏览时不会发生问题。
2、使用客户端报表设计器设计报表时,添加数据源问题,通过ODBC连接数据源时,Cache数据库不能得到数据源的表结构,无法添加数据源,所以只用Cache库就无法使用客户端报表设计器设计报表文件repx,然后通过页面调用repx报表文件的形式。
3、启动带有报表的项目时或运行时都耗内存,运行速度慢。
注:
//文中省略的使用ado.net连接数据源代码
SqlConnection connect = new SqlConnection();
try{
SqlCommand command = new SqlCommand();
SqlDataAdapter da = new SqlDataAdapter();
string strConn = \"server=HDCC-E; database=reportTest; User Id=sa; pwd=123;\";
connect.ConnectionString = strConn;
command.Connection = (SqlConnection)connect;
da = new SqlDataAdapter(command);
if (connect.State != ConnectionState.Open) {
connect.Open();
}
DataSet ds = new DataSet();
command.CommandText = \" SELECT * FROM PersonInfo \";
command.CommandType = CommandType.Text;
da.SelectCommand = command;
da.Fill(ds);
return ds;
}
catch (Exception e) {
return null;
}
finally{
if (connect.State == ConnectionState.Open) {
connect.Close();
}
}