Aspose words API - 邮件合并功能 - “合并”文本可以是富文本（带有样式/图像/项目符号/表格）吗？

Question

寻找可以使用富文本执行邮件合并类型功能的 word api。基本上，文本将是带有字体样式的富文本/格式化文本，并且会有

a) images
b) bullets
c) tables

总体目的：创建带有书签的单词模板。从数据库中获取数据（对于那些字段）并插入。数据将是 html 文本/富文本。自动生成word文档。 python 或 .net api 将是首选。

Can Aspose.words work with richtext as described above?  Any other recommendations for excellent word APIs?

Answer 1

是的，您可以使用 Aspose.Words 实现此目的。您可以使用 IFieldMergingCallback 在邮件合并时插入格式化文本。例如，请参阅以下链接 https://apireference.aspose.com/words/net/aspose.words.mailmerging/ifieldmergingcallback 如果是到达文本（如果您指的是 RTF 或 MarkDown 格式），您首先需要将此内容读入 Document 的单独实例，然后使用 DocumentBuilder.InsertDocument 方法 https://apireference.aspose.com/words/net/aspose.words/documentbuilder/methods/insertdocument

以下代码示例展示了如何在 IFieldMergingCallback 中使用 InsertHtml 方法

[Test]
public void Test001()
{
    Document doc = new Document(@"C:\Temp\in.docx");
    doc.MailMerge.FieldMergingCallback = new HandleMergeFieldInsertHtml();
    const string html = @"<h1>Hello world!</h1>";
    doc.MailMerge.Execute(new string[] { "myField" }, new object[] { html });
    doc.Save(@"C:\Temp\out.docx");
}

private class HandleMergeFieldInsertHtml : IFieldMergingCallback
{
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        FieldMergeField field = args.Field;

        // Insert the text for this merge field as HTML data, using DocumentBuilder
        DocumentBuilder builder = new DocumentBuilder(args.Document);
        builder.MoveToMergeField(args.DocumentFieldName);
        builder.Write(field.TextBefore ?? "");
        builder.InsertHtml((string)args.FieldValue);

        // The HTML text itself should not be inserted
        // We have already inserted it as an HTML
        args.Text = "";
    }

    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        // Do nothing
    }
}

如果您想手动格式化文本，则可以使用 DocumentBuilder 适当的属性。

[Test]
public void Test001()
{
    Document doc = new Document(@"C:\Temp\in.docx");
    doc.MailMerge.FieldMergingCallback = new HandleMergeFieldInsertText();
    const string text = @"Hello world!";
    doc.MailMerge.Execute(new string[] { "myField" }, new object[] { text });
    doc.Save(@"C:\Temp\out.docx");
}

private class HandleMergeFieldInsertText : IFieldMergingCallback
{
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        FieldMergeField field = args.Field;

        DocumentBuilder builder = new DocumentBuilder(args.Document);
        builder.MoveToMergeField(args.DocumentFieldName);
        // Apply style or other formatting.
        builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
        builder.Write(field.TextBefore ?? "");
        builder.Write((string)args.FieldValue);

        // The  text itself should not be inserted
        // We have already inserted it using DocumentBuilder.
        args.Text = "";
    }

    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        // Do nothing
    }
}

希望这会有所帮助。 披露：我在 Aspose.Words 团队工作。