[原创]Devexpress XtraReports 系列 9 创建邮件合并报表

时间:2022-05-01 12:51:32

昨天发表了Devexpress XtraReports系列第八篇[原创]Devexpress XtraReports 系列 8 创建Drill-Through报表,今天我们继续。

今天的主题是创建邮件合并报表。

什么是邮件合并报表呢?

回答:数据字段被嵌入到标签控件的文本中,并在预览或导出报表时被替换为相应的数据取值。

邮件合并功能:一般报表,我们不能指定为单个属性指定一个以上的数据绑定,而“邮件合并”则允许把多个数据字段合并到文本中。

注意:字段需要用[]括起来

支持邮件合并的控件有:

  • XRBarCode
  • XRCheckBox
  • XRLabel
  • XRRichText
  • XRTableCell
  • XRZipCode

首先我们来看看最后实现的效果。Demo最后附上。

[原创]Devexpress XtraReports 系列 9 创建邮件合并报表

接下来开始讲解如何一步一步做出这个报表:

第一步

创建如上窗体,拉入控件SimpleButton,DocumentViewer,SplitContainerControl,LabelControl,TextEdit,GroupControl,简单布局我就不多说了,跟上篇一样的布局 ,详见:http://www.cnblogs.com/lhmlyx2723356/p/3286101.html

第二步

创建一个报表文件。如图:

[原创]Devexpress XtraReports 系列 9 创建邮件合并报表

第三步

我们利用数据库做一张简单的表并输入一些测试值。如图:

[原创]Devexpress XtraReports 系列 9 创建邮件合并报表

第四步

数据库表,布局都做好了,接下来我们就来处理相对应的事件了。输入文本框的值,点击按钮把查询出来的数据源绑定到报表

a,修改报表文件的构造函数,让它在实例化的时候可以接收数据源。

public MailMergeRpt(DataSet ds)
      {
          InitializeComponent();
          this.DataSource = ds;
          this.DataMember = "MailMegerRpt";
      }

//为了让XRRichText控件中承载的XRPictureBox控件显示出数据库中测试数据中的jpg图片,其实这些图片是存放在程序运行目录下,如图:

[原创]Devexpress XtraReports 系列 9 创建邮件合并报表

那如何让图片显示出来呢?

我们应该处理XRPictureBox控件的BeforePrint 事件。

private void xrPictureBox1_BeforePrint(object sender, System.Drawing.Printing.PrintEventArgs e)
   {
       string path = System.Environment.CurrentDirectory + "\\" + GetCurrentColumnValue("pictureurl");
       xrPictureBox1.Sizing = DevExpress.XtraPrinting.ImageSizeMode.ZoomImage;
       ((XRPictureBox)sender).Image = Image.FromFile(path);
   }

b,获取数据源

private DataSet BindRpt()
      {
          DataSet ds = new DataSet();
          try
          {
              SqlConnection con = new SqlConnection("Data Source=(local);Integrated Security=SSPI;Initial Catalog=ReportDeom");
              SqlDataAdapter adapter;
              con.Open();
              SqlCommand cmd = new SqlCommand("SELECT * FROM Dept where dept_name=@name OR @name='' ", con);
              SqlParameter[] paras = new SqlParameter[]{
                  new SqlParameter("@name",txtName.Text.Trim())
              };
              cmd.Parameters.AddRange(paras);
              adapter = new SqlDataAdapter(cmd);
              adapter.Fill(ds, "MailMegerRpt"); ;
              con.Close();
          }
          catch (Exception ex)
          {
              throw ex;
          }
          return ds;
      }

c,单击按钮,绑定数据到报表中

private void btnShowReport_Click(object sender, EventArgs e)
{
     DataSet ds = BindRpt();
     MailMergeRpt Rpt = new MailMergeRpt(ds);
     this.documentViewer1.DocumentSource = Rpt;
     Rpt.CreateDocument();
}

到此,邮件合并报表就完成了。

Demo地址:http://yunpan.cn/QXIpty8CBHdr5  访问密码 56c9