XtraReport应用(1)(XtraReport From File)

最近在研究dev xtraReport的应用，虽然从08年就开始接触dev，但是它的报表还是头次接触。在网上找了很多资料，但看来看去无非就那么两篇，呵呵，真是天下文章一大抄！相对水晶报表，xtraReport在设计上是很强大的，在功能上也要比水晶报表完善很多。但是在这里要吐槽一下，dev的demo写的真的不咋地，效果是出来了，找代码还得找半天还不应定能找到。

言归正传，今天主要说的单表显现和简单主从表显现实现。相对于国外报表来讲，国内的报表很有中国特色，中规中矩的，所以也给设计人员带来了些许方便。先来说说单表的报表实现。我在这里使用的是xtraReport的设计器来设计的报表，有兴趣的可以从demo-xtraReports-RibbonReportDesigner打开它。在设计上，和水晶报表的设计有不同，但是参数的标识也是用"[]"的。

1、单表

报表设计

网页运行效果

后台代码（Ps：数据库不是我的，大家不要喷我~~）

数据层

public DataTable GetData()
        {
            using (SqlConnection conn = new SqlConnection(connectionString))
            {
                string _commandSql="SELECT [ID],[名称],[添加时间] FROM [部门表]";
                using (SqlDataAdapter da = new SqlDataAdapter(_commandSql, conn))
                {
                    DataSet ds = new DataSet();
                    da.Fill(ds);
                    return ds.Tables[0];
                }
            }
        }

实体类

public class Dept
    {
        public string ID{get;set;}
        public string Name { get; set; }
        public DateTime?  CreateTime { get; set; }
    }

前台页面

<dx:ReportToolbar ID="ReportToolbar1" runat="server" ReportViewerID="ReportViewer1" ShowDefaultButtons="False">
            <Items>
                <dx:ReportToolbarButton ItemKind="Search" />
                <dx:ReportToolbarSeparator />
                <dx:ReportToolbarButton ItemKind="PrintReport" />
                <dx:ReportToolbarButton ItemKind="PrintPage" />
                <dx:ReportToolbarSeparator />
                <dx:ReportToolbarButton Enabled="False" ItemKind="FirstPage" />
                <dx:ReportToolbarButton Enabled="False" ItemKind="PreviousPage" />
                <dx:ReportToolbarLabel ItemKind="PageLabel" />
                <dx:ReportToolbarComboBox ItemKind="PageNumber" Width="65px">
                </dx:ReportToolbarComboBox>
                <dx:ReportToolbarLabel ItemKind="OfLabel" />
                <dx:ReportToolbarTextBox IsReadOnly="True" ItemKind="PageCount" />
                <dx:ReportToolbarButton ItemKind="NextPage" />
                <dx:ReportToolbarButton ItemKind="LastPage" />
                <dx:ReportToolbarSeparator />
                <dx:ReportToolbarButton ItemKind="SaveToDisk" />
                <dx:ReportToolbarButton ItemKind="SaveToWindow" />
                <dx:ReportToolbarComboBox ItemKind="SaveFormat" Width="70px">
                    <elements>
                        <dx:ListElement Value="pdf" />
                        <dx:ListElement Value="xls" />
                        <dx:ListElement Value="xlsx" />
                        <dx:ListElement Value="rtf" />
                        <dx:ListElement Value="mht" />
                        <dx:ListElement Value="html" />
                        <dx:ListElement Value="txt" />
                        <dx:ListElement Value="csv" />
                        <dx:ListElement Value="png" />
                    </elements>
                </dx:ReportToolbarComboBox>
            </Items>
            <styles>
                <LabelStyle><Margins MarginLeft='3px' MarginRight='3px' /></LabelStyle>
            </styles>
        </dx:ReportToolbar>
        <br />
        <dx:ReportViewer ID="ReportViewer1" runat="server">
        </dx:ReportViewer>

前台代码（重要）

protected void Page_Load(object sender, EventArgs e)
        {
            DataTable dt = new Controller().GetData();
            List<Dept> list = new List<Dept>();
            Dept deptInfo = null;

            for (int i = 0; i < dt.Rows.Count; i++)
            {
                deptInfo = new Dept()
                {
                    ID = dt.Rows[i]["ID"].ToString(),
                    Name = dt.Rows[i]["名称"].ToString()
                 
                };
                if (dt.Rows[i]["添加时间"] == null)
                    deptInfo.CreateTime = null;
                else
                    deptInfo.CreateTime = Convert.ToDateTime(dt.Rows[i]["添加时间"]);
                list.Add(deptInfo);
            }

            XtraReport xpr = null;
            if (dt != null)
            {
                xpr = XtraReport.FromFile(Server.MapPath("~") + "dept.repx", true);
                xpr.DataSource = list;
            }
            xpr.CreateDocument();
            ReportViewer1.Report = xpr;
            ReportViewer1.DataBind();
        }

这里要说的是：由于使用的List<>，所以在设计报表的时候，报表参数名称要和实体对象中的属性名称相一致。

对于奇偶行样式，可通过EvenStyle和OddStyle来设计实现。

2、主从表

报表设计

对于主从表的报表设计，建议使用Group和DetailReport来实现。

网页运行效果

数据层

public DataSet GetMasterDetailData()
        {
            using (SqlConnection conn = new SqlConnection(connectionString))
            {
                string _masterCommandSql = "SELECT [ID],[名称],[添加时间] FROM [部门表]";
                string _detailCommandSql = "SELECT [编号],[姓名],[添加时间],[部门ID] FROM [用户表]";
                DataSet ds = new DataSet();
                using (SqlDataAdapter da = new SqlDataAdapter(_masterCommandSql, conn))
                {
                    da.Fill(ds,"Master");
                }
                using (SqlDataAdapter da = new SqlDataAdapter(_detailCommandSql, conn))
                {
                    da.Fill(ds,"Detail");
                }
                return ds;
            }
        }

前台页面

<dx:ReportToolbar ID="ReportToolbar1" runat="server" ShowDefaultButtons="False" ReportViewerID="ReportViewer1">
            <Items>
                <dx:ReportToolbarButton ItemKind="Search" />
                <dx:ReportToolbarSeparator />
                <dx:ReportToolbarButton ItemKind="PrintReport" />
                <dx:ReportToolbarButton ItemKind="PrintPage" />
                <dx:ReportToolbarSeparator />
                <dx:ReportToolbarButton Enabled="False" ItemKind="FirstPage" />
                <dx:ReportToolbarButton Enabled="False" ItemKind="PreviousPage" />
                <dx:ReportToolbarLabel ItemKind="PageLabel" />
                <dx:ReportToolbarComboBox ItemKind="PageNumber" Width="65px">
                </dx:ReportToolbarComboBox>
                <dx:ReportToolbarLabel ItemKind="OfLabel" />
                <dx:ReportToolbarTextBox IsReadOnly="True" ItemKind="PageCount" />
                <dx:ReportToolbarButton ItemKind="NextPage" />
                <dx:ReportToolbarButton ItemKind="LastPage" />
                <dx:ReportToolbarSeparator />
                <dx:ReportToolbarButton ItemKind="SaveToDisk" />
                <dx:ReportToolbarButton ItemKind="SaveToWindow" />
                <dx:ReportToolbarComboBox ItemKind="SaveFormat" Width="70px">
                    <elements>
                        <dx:ListElement Value="pdf" />
                        <dx:ListElement Value="xls" />
                        <dx:ListElement Value="xlsx" />
                        <dx:ListElement Value="rtf" />
                        <dx:ListElement Value="mht" />
                        <dx:ListElement Value="html" />
                        <dx:ListElement Value="txt" />
                        <dx:ListElement Value="csv" />
                        <dx:ListElement Value="png" />
                    </elements>
                </dx:ReportToolbarComboBox>
            </Items>
            <styles>
                <LabelStyle><Margins MarginLeft='3px' MarginRight='3px' /></LabelStyle>
            </styles>
        </dx:ReportToolbar>
        <dx:ReportViewer ID="ReportViewer1" runat="server">
        </dx:ReportViewer>

前台代码

protected void Page_Load(object sender, EventArgs e)
        {
            DataSet ds=new Controller().GetMasterDetailData();

            DataColumn masterColumn=ds.Tables["Master"].Columns["ID"];
            DataColumn detailColumn=ds.Tables["Detail"].Columns["部门ID"];

            DataRelation relation = new DataRelation("relation1",masterColumn,detailColumn);
            ds.Relations.Add(relation);

            XtraReport xpr = XtraReport.FromFile(Server.MapPath("~") + "dept_and_users.repx", true);

            GroupField gf = new GroupField("ID", XRColumnSortOrder.Ascending);
            ((GroupHeaderBand)(xpr.FindControl("GroupHeader1", true))).GroupFields.Add(gf);

            xpr.DataMember = "Master";
            xpr.DataSource = ds;

            

            ((DetailBand)(xpr.FindControl("Detail1", true))).Report.DataMember = "relation1";
            ((DetailBand)(xpr.FindControl("Detail1", true))).Report.DataSource = ds;
            
            //xpr.FindControl("tableCell10", true).DataBindings.Add("Text", ds, "relation1.编号");
            //xpr.FindControl("tableCell11", true).DataBindings.Add("Text", ds, "relation1.姓名");
            //xpr.FindControl("tableCell12", true).DataBindings.Add("Text", ds, "relation1.添加时间");

            XRTableCellCollection cc = ((XRTable)(xpr.FindControl("table4", true))).Rows[0].Cells;
            BindingFields(ds,cc,"relation.");
            xpr.CreateDocument();
            ReportViewer1.Report = xpr;
            ReportViewer1.DataBind();
        }

        private void BindingFields(DataSet ds, XRTableCellCollection cc,string relationName)
        {
            for (int i = 0; i < ds.Tables["Detail"].Columns.Count-1; i++)
            {
                cc[i].DataBindings.Add("Text", ds, relationName + ds.Tables["Detail"].Columns[i].Caption);
            }
        }

这里需要注意的几点，这几点都是必需的：1、设定dataset中表与表之间的关系

DataColumn masterColumn=ds.Tables["Master"].Columns["ID"];
DataColumn detailColumn=ds.Tables["Detail"].Columns["部门ID"];

DataRelation relation = new DataRelation("relation1",masterColumn,detailColumn);
ds.Relations.Add(relation);

2、设定groupheader的分组依据字段

GroupField gf = new GroupField("ID", XRColumnSortOrder.Ascending);
2 ((GroupHeaderBand)(xpr.FindControl("GroupHeader1", true))).GroupFields.Add(gf);

3、成员绑定

xpr.DataMember = "Master";
xpr.DataSource = ds;
((DetailBand)(xpr.FindControl("Detail1", true))).Report.DataMember = "relation1";
((DetailBand)(xpr.FindControl("Detail1", true))).Report.DataSource = ds;

对于从表的数据绑定，都需要使用DataBindings属性，所以，下面的代码要这样写：

XRTableCellCollection cc = ((XRTable)(xpr.FindControl("table4", true))).Rows[0].Cells;
BindingFields(ds,cc,"relation.");

private void BindingFields(DataSet ds, XRTableCellCollection cc,string relationName)
        {
            for (int i = 0; i < ds.Tables["Detail"].Columns.Count-1; i++)
            {
                cc[i].DataBindings.Add("Text", ds, relationName + ds.Tables["Detail"].Columns[i].Caption);
            }
        }

上面就是从报表设计器设计报表，从代码中调用报表的全部内容。当然还有直接在VS当中创建报表，这种方式和上面的操作大同小异，而且网上的代码也很多，这里就不再介绍了。还有一种方式就是运行时创建报表，这样的好处是，在报表表头、表尾大体相同的情况下，可以省下很大一部分时间。园子里这样的文章不少，也不乏写的好的，大家都找找吧。