FieldMergingArgs

FieldMergingArgs class

提供数据合并字段事件.

要了解更多信息,请访问邮件合并和报告文档文章。

public class FieldMergingArgs : FieldMergingArgsBase

特性

姓名描述
Document { get; }返回Document执行邮件合并的对象。
DocumentFieldName { get; }获取文档中指定的合并字段的名称。
Field { get; }获取表示当前合并字段的对象。
FieldName { get; }获取数据源中合并字段的名称。
FieldValue { get; set; }从数据源获取或设置字段的值。
RecordIndex { get; }获取正在合并的记录的从零开始的索引。
TableName { get; }获取当前合并操作的数据表的名称,如果名称不可用,则获取空字符串。
Text { get; set; }获取或设置将插入当前合并字段文档中的文本。

评论

合并字段当文档中遇到简单的邮件 merge 字段时,在邮件合并期间会发生事件。您可以响应此事件以 return 文本,以便邮件合并引擎插入到文档中。

例子

演示如何使用自定义回调执行邮件合并,该回调处理 HTML 文档形式的合并数据。

public void MergeHtml()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.InsertField(@"MERGEFIELD  html_Title  \b Content");
    builder.InsertField(@"MERGEFIELD  html_Body  \b Content");

    object[] mergeData =
    {
        "<html>" +
            "<h1>" +
                "<span style=\"color: #0000ff; font-family: Arial;\">Hello World!</span>" +
            "</h1>" +
        "</html>", 

        "<html>" +
            "<blockquote>" +
                "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>" +
            "</blockquote>" +
        "</html>"
    };

    doc.MailMerge.FieldMergingCallback = new HandleMergeFieldInsertHtml();
    doc.MailMerge.Execute(new[] { "html_Title", "html_Body" }, mergeData);

    doc.Save(ArtifactsDir + "MailMergeEvent.MergeHtml.docx");
}

/// <summary>
/// 如果邮件合并遇到名称以“html_”前缀开头的MERGEFIELD,
/// 此回调将其合并数据解析为 HTML 内容,并将结果添加到 MERGEFIELD 的文档位置。
/// </summary>
private class HandleMergeFieldInsertHtml : IFieldMergingCallback
{
    /// <summary>
    /// 当邮件合并将数据合并到 MERGEFIELD 时调用。
    /// </summary>
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        if (args.DocumentFieldName.StartsWith("html_") && args.Field.GetFieldCode().Contains("\\b"))
        {
            // 将解析后的 HTML 数据添加到文档正文中。
            DocumentBuilder builder = new DocumentBuilder(args.Document);
            builder.MoveToMergeField(args.DocumentFieldName);
            builder.InsertHtml((string)args.FieldValue);

            // 由于我们已经手动插入了合并的内容,
             // 我们不需要通过“Text”属性返回内容来响应此事件。
            args.Text = string.Empty;
        }
    }

    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        // 没做什么。
    }
}

也可以看看