在 XtraReports 中 绑定报表控件 的标准方式，类似于 Windows 窗体 (中的绑定方式)。 需要把数据绑定添加到控件的 XRControl.DataBindings 集合中。 在这种情况下，可以为当前报表控件绑定多个可用的可绑定属性，并且分别为它们指定格式字符串。 但是，在这种情况下，不能指定为单个属性指定一个以上的数据绑定，而“邮件合并”则允许把多个数据字段合并到文本中。

注意
按照定义，邮件合并只能应用于 XRControl.Text 属性。

大体上，要创建嵌入字段，则需要把由 [中括号] 括起的数据字段名称插入到控件的文本中 (例如 XRLabel 或 XRRichText)。

注意
字段名称中不应该包含圆点和空格，以便于 XtraReports 正确解析。

如果在当前的数据上下文中，字段是有效的，那么当报表被预览或导出时，它将被替换为一个适当的数据值。

如果插入到标签文本中的数据字段是有效的，那么可以看到显示在控件上的数据库桶状图标。 如果控件通过 XRControl.DataBindings 属性被绑定，也显示相同的图标。 因为数据字段被插入到标签的文本中，因此也可以使用任何前缀或后缀。 此外，还可以把几个嵌入字段插入到一个控件的 Text 中，并且所有这些被嵌入的字段都能被正确处理。

注意
必须在设计时刻把有中括号的文本设置到 XRControl.Text 属性，或者在运行时刻在 XtraReport.CreateDocument 方法被调用之前设置。 因此，如果在报表生成启动之后，例如在 XRControl.BeforePrint 事件处理程序中，才把文本提供给控件，那么邮件合并功能不工作。 此外，如果通过 数据绑定，被存储在报表数据源中并被放置在报表控件中的文本也包含了中括号，那么将不能启用邮件合并功能。

要把 参数 值嵌入到控件的内容中，应使用 Parameters.ParameterName 语法。

对于继承自 XRFieldEmbeddableControl 类的所有报表控件的 Text 属性，都可以应用邮件合并功能。 在此 XtraReports 版本中，下列控件支持邮件合并。

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