自动创建个性化文档(如报告、信件和发票)可以显著提高工作流的效率. 通过 Aspose.Words 为 .NET 驱动的 C# Mail Merge,您可以轻松地实现这一点. 本指南将通过使用 Aspose。Word 邮件融合插件 进行有效和可扩展的文件生成,在您的 .NET 应用程序中 - 无需 MS Word 或 Office Interop 的需要。

内容

什么是邮件合并?

Mail Merge 是一种强大的方法,可以通过从各种来源获取数据来动态创建文档。 Aspose.Words 可自动化以下任务:

  • 创建个性化的信件和发票。
  • 使用结构化格式,如 XML、JSON 或数据库创建大规模报告,可使用 C# 和 Aspose.Words 进行动态报告生成。

邮件的数据来源

Aspose.Words 支持各种数据来源,包括:

  • 对象:使用类例的受欢迎模板。
  • XML:为动态字段加载结构化数据。
  • JSON:易于与现代API集成。
  • CSV:为大批文件生成提供表数据。
  • DataTable/DataSet: 使用 ADO.NET 进行数据库集成。

准备邮件合并模板

邮件合并模板是包含合并字段的文档,在执行过程中将与您指定的数据来源的数据积累。 该模板可以是DOC或DOCX格式,不需要特定的风格。

  • 打开文档或在 MS Word 中创建一个新的文档。
  • 放置在您想要输入合并字段的折叠器。
  • 从 输入 菜单中,选择 区域 选项。
  • 从 区域名称 列表中,选择 MergeField。
  • 在 字段名称 框中指定合并字段的名称,然后单击 OK。
  • 保存文件。

下面的屏幕截图显示了一个 样品模板 文件。

Mail Merge Template

.NET Mail Merge API - 安装

您可以通过各种方法安装 Aspose.Words for .NET:

在 Word 文档中执行邮件合并,使用 C#

一旦您的模板准备好,您可以执行邮件合并以生成文件。

下面是一个代码样本,展示如何在C#中使用一系列值进行 自动报告生成:

邮件合并后文档

Execute Mail Merge in C#

在 C# 中使用 XML 数据源进行邮件合并。

XML 文件通常用于存储和传输数据。 Aspose.Words for .NET 支持 XML 为邮件合并操作的数据来源。 DataSet 对象并执行邮件合并. 下面是我们使用案例的样本 XML 文件。

<customers>
    <customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
    <customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
    <customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
    <customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>

下面的代码样本从 XML 数据源中获取数据,并使用 C# 执行邮件合并。

下面是邮件合并 寺庙 它将由 XML 文件中的数据集成。

Mail Merge Template for XML

此图像代表发送邮件合并后获得的结果文档的第一页。

Execute Mail Merge with XML in C#

合并字段的自定义格式化

Aspose.Words for .NET 提供增强电子邮件合并过程的控制。 MailMerge.FieldMergingCallback 属性允许您设置邮件合并行为,因为每个合成字段相遇。 IFieldMergingCallback.FieldMerging 和 IFieldMergingCallback.ImageFieldMerging 方法允许自定义邮件合并操作。

下面是一个代码样本,展示如何在邮件合并期间应用自定义格式,通过所提供的示例样本:

下列实施 HandleMergeFieldAlternatingRows 类。

邮件合并与区域使用 C#

在某些情况下,您可能需要在Word文档中定居并重复一个特定的区域. 对于此类情况,请使用邮件合并与区域。 创建一个区域,指定该区域的起点和结束; 随后将此区域为数据来源的每个记录重演。

Mail Merge Template with Regions

下面是一个代码样本,以上述区域进行邮件合并 寺庙.

下面的方法描述了如何从数据库中阅读数据。

此分類上一篇: Nested Mail Merge

通常,源的数据是结构化在关系格式. 例如,“订单”可能有一个与“订购细节”的关系,这保留记录的项目在一个命令内。 发票模板 这就适合这个场景了。

Mail Merge Template with Regions

下面是一個XML資料來源,為我們的Nested Mail合併的例子。

<?xml version="1.0" encoding ="utf-8"?>
<Orders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="OrdersSchema.xsd">
    <Order>
        <Number>23</Number>
        <Address>Nelson Street</Address>
        <Suburb>Howick</Suburb>
        <City>Auckland</City>
        <Phonenumber>543 1234</Phonenumber>
        <Date>03/01/2010</Date>
        <Total>14.00</Total>
        <Item>
            <Name>BBQ Chicken Pizza</Name>
            <Price>6.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>6.00</ItemTotal>
        </Item>
        <Item>
            <Name>1.5 Litre Coke</Name>
            <Price>4.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>8.00</ItemTotal>
        </Item>
    </Order>
    <Order>
        <Number>10</Number>
        <Address>Parkville Avenue</Address>
        <Suburb>Pakuranga</Suburb>
        <City>Auckland</City>
        <Phonenumber>548 7342</Phonenumber>
        <Date>05/03/2010</Date>
        <Total>6.00</Total>
        <Item>
            <Name>Hawaiian Pizza</Name>
            <Price>4.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>4.00</ItemTotal>
        </Item>
        <Item>
            <Name>Fries</Name>
            <Price>1.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>2.00</ItemTotal>
        </Item>
    </Order>
</Orders>

此 XML 的相应 OrderSchema.xsd 文件是:

<?xml version="1.0" encoding ="utf-8"?>
<xs:schema id="OrdersSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Orders">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="Order">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="Number"/>
                            <xs:element name="Address"/>
                            <xs:element name="Suburb"/>
                            <xs:element name="City"/>
                            <xs:element name="Phonenumber"/>
                            <xs:element name="Date"/>
                            <xs:element name="Total"/>
                            <xs:element name="Item">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="Name"/>
                                        <xs:element name="Price"/>
                                        <xs:element name="Quantity"/>
                                        <xs:element name="ItemTotal"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

下面的代码样本将使用 C# 执行邮件合并。

邮件合并后文档

下面是完成邮件合并后获得的结果文件的第一个页面。

Word Document after Mail Merge

结论

Aspose.Words for .NET 是一个全面的邮件合并 API,提供适用于 .net 应用程序的标准和扩展功能。 只有几行代码,您可以从各种数据来源无缝开发简单或复杂的报告。 人们在说什么要从 Aspose.Words 为 .NET 开始,请探索可用的 开发者的指南 样品代码在 GitHub. 此外, Aspose Plugin 还提供先进的报告生成功能。

尝试 Aspose.Words for .NET for 免费

您可以获得免费的临时许可证来尝试 Aspose.Words 为 .NET 无限制。 您现在获得临时许可证.

More in this category