IMailMergeCallback

IMailMergeCallback interface

如果您想在执行邮件合并时接收通知，请实现此接口。

public interface IMailMergeCallback

方法

姓名 描述
TagsReplaced() 当“mustache”文本标签替换为 MERGEFIELD 字段时调用。

例子

展示如何定义自定义逻辑以在邮件合并期间处理事件。

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

    // 在数据源中插入两个引用两列的邮件合并标签。
    builder.Write("{{FirstName}}");
    builder.Write("{{LastName}}");

    // 创建一个只包含我们的合并标签引用的列之一的数据源。
    DataTable table = new DataTable("Test");
    table.Columns.Add("FirstName");
    table.Rows.Add("John");
    table.Rows.Add("Jane");

    // 配置我们的邮件合并以使用替代邮件合并标签。
    doc.MailMerge.UseNonMergeFields = true;

    // 然后，确保邮件合并会转换标签，比如我们的“LastName”标签，
    // 进入合并文档中的 MERGEFIELD。
    doc.MailMerge.PreserveUnusedTags = false;

    MailMergeTagReplacementCounter counter = new MailMergeTagReplacementCounter();
    doc.MailMerge.MailMergeCallback = counter;
    doc.MailMerge.Execute(table);

    Assert.AreEqual(1, counter.TagsReplacedCount);
}

/// <summary>
/// 计算邮件合并替换无法使用 MERGEFIELD 数据填充的邮件合并标记的次数。
/// </summary>
private class MailMergeTagReplacementCounter : IMailMergeCallback
{
    public void TagsReplaced()
    {
        TagsReplacedCount++;
    }

    public int TagsReplacedCount { get; private set; }
}

也可以看看

IFieldMergingCallback IMailMergeDataSource