Chèn tài liệu khi trộn thư

Giới thiệu

Chào mừng bạn đến với thế giới tự động hóa tài liệu với Aspose.Words cho .NET! Bạn đã bao giờ tự hỏi làm thế nào để chèn động tài liệu vào các trường cụ thể trong tài liệu chính trong quá trình trộn thư chưa? Vâng, bạn đang ở đúng nơi. Hướng dẫn này sẽ hướng dẫn bạn từng bước trong quá trình chèn tài liệu vào các trường trộn thư bằng Aspose.Words cho .NET. Nó giống như việc ghép một câu đố, trong đó mỗi mảnh ghép vào đúng vị trí một cách hoàn hảo. Vì vậy, hãy đi sâu vào!

Điều kiện tiên quyết

Trước khi chúng ta bắt đầu, hãy đảm bảo bạn có những điều sau:

Aspose.Words cho .NET: Bạn có thểTải về phiên bản mới nhất tại đây . Nếu bạn cần mua giấy phép, bạn có thể làm như vậyđây . Ngoài ra, bạn có thể nhận được mộtgiấy phép tạm thời hoặc thử nó với mộtdùng thử miễn phí.
Môi trường phát triển: Visual Studio hoặc bất kỳ IDE C# nào khác.
Kiến thức cơ bản về C#: Làm quen với lập trình C# sẽ giúp cho hướng dẫn này trở nên dễ dàng.

Nhập không gian tên

Trước tiên, bạn cần nhập các không gian tên cần thiết. Đây giống như các khối xây dựng của dự án của bạn.

using System;
using Aspose.Words;
using Aspose.Words.MailMerging;
using System.Linq;

Hãy chia nhỏ quy trình thành các bước có thể quản lý được. Mỗi bước sẽ được xây dựng dựa trên bước trước đó, đưa bạn đến một giải pháp hoàn chỉnh.

Bước 1: Thiết lập thư mục của bạn

Trước khi có thể bắt đầu chèn tài liệu, bạn cần xác định đường dẫn đến thư mục tài liệu của mình. Đây là nơi tài liệu của bạn được lưu trữ.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Bước 2: Tải tài liệu chính

Tiếp theo, bạn sẽ tải tài liệu chính. Tài liệu này chứa các trường hợp nhất nơi các tài liệu khác sẽ được chèn vào.

Document mainDoc = new Document(dataDir + "Document insertion 1.docx");

Bước 3: Đặt cuộc gọi lại hợp nhất trường

Để xử lý quá trình hợp nhất, bạn sẽ cần đặt chức năng gọi lại. Hàm này sẽ chịu trách nhiệm chèn tài liệu vào các trường hợp nhất được chỉ định.

mainDoc.MailMerge.FieldMergingCallback = new InsertDocumentAtMailMergeHandler();

Bước 4: Thực hiện trộn thư

Bây giờ là lúc thực hiện việc trộn thư. Đây là nơi phép thuật xảy ra. Bạn sẽ chỉ định trường hợp nhất và tài liệu sẽ được chèn vào trường này.

mainDoc.MailMerge.Execute(new[] { "Document_1" }, new object[] { dataDir + "Document insertion 2.docx" });

Bước 5: Lưu tài liệu

Sau khi phối thư hoàn tất, bạn sẽ lưu tài liệu đã sửa đổi. Tài liệu mới này sẽ có nội dung được chèn vào đúng nơi bạn muốn.

mainDoc.Save(dataDir + "CloneAndCombineDocuments.InsertDocumentAtMailMerge.doc");

Bước 6: Tạo Trình xử lý gọi lại

Trình xử lý gọi lại là một lớp thực hiện xử lý đặc biệt cho trường hợp nhất. Nó tải tài liệu được chỉ định trong giá trị trường và chèn nó vào trường hợp nhất hiện tại.

private class InsertDocumentAtMailMergeHandler : IFieldMergingCallback
{
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        if (args.DocumentFieldName == "Document_1")
        {
            DocumentBuilder builder = new DocumentBuilder(args.Document);
            builder.MoveToMergeField(args.DocumentFieldName);

            Document subDoc = new Document((string)args.FieldValue);
            InsertDocument(builder.CurrentParagraph, subDoc);

            if (!builder.CurrentParagraph.HasChildNodes)
                builder.CurrentParagraph.Remove();

            args.Text = null;
        }
    }
}

Bước 7: Chèn tài liệu

Phương pháp này chèn tài liệu đã chỉ định vào đoạn văn hoặc ô bảng hiện tại.

private static void InsertDocument(Node insertionDestination, Document docToInsert)
{
    if (insertionDestination.NodeType == NodeType.Paragraph || insertionDestination.NodeType == NodeType.Table)
    {
        CompositeNode destinationParent = insertionDestination.ParentNode;
        NodeImporter importer = new NodeImporter(docToInsert, insertionDestination.Document, ImportFormatMode.KeepSourceFormatting);

        foreach (Section srcSection in docToInsert.Sections.OfType<Section>())
        foreach (Node srcNode in srcSection.Body)
        {
            if (srcNode.NodeType == NodeType.Paragraph)
            {
                Paragraph para = (Paragraph)srcNode;
                if (para.IsEndOfSection && !para.HasChildNodes)
                    continue;
            }

            Node newNode = importer.ImportNode(srcNode, true);
            destinationParent.InsertAfter(newNode, insertionDestination);
            insertionDestination = newNode;
        }
    }
    else
    {
        throw new ArgumentException("The destination node should be either a paragraph or table.");
    }
}

Phần kết luận

Và bạn có nó rồi đấy! Bạn đã chèn thành công tài liệu vào các trường cụ thể trong quá trình trộn thư bằng Aspose.Words cho .NET. Tính năng mạnh mẽ này có thể giúp bạn tiết kiệm rất nhiều thời gian và công sức, đặc biệt khi xử lý khối lượng tài liệu lớn. Hãy nghĩ về việc có một trợ lý cá nhân đảm nhận mọi công việc nặng nhọc cho bạn. Vì vậy, hãy tiếp tục và thử xem. Chúc mừng mã hóa!

Câu hỏi thường gặp

Tôi có thể chèn nhiều tài liệu vào các trường hợp nhất khác nhau không?

Vâng, bạn có thể. Chỉ cần chỉ định các trường hợp nhất thích hợp và đường dẫn tài liệu tương ứng trongMailMerge.Execute phương pháp.

Có thể định dạng tài liệu được chèn khác với tài liệu chính không?

Tuyệt đối! Bạn có thể dùngImportFormatMode các thông số trongNodeImporter để kiểm soát việc định dạng.

Điều gì xảy ra nếu tên trường hợp nhất là động?

Bạn có thể xử lý tên trường hợp nhất động bằng cách chuyển chúng dưới dạng tham số cho trình xử lý gọi lại.

Tôi có thể sử dụng phương pháp này với các định dạng tệp khác nhau không?

Có, Aspose.Words hỗ trợ nhiều định dạng tệp khác nhau bao gồm DOCX, PDF, v.v.

Làm cách nào để xử lý lỗi trong quá trình chèn tài liệu?

Triển khai xử lý lỗi trong trình xử lý gọi lại của bạn để quản lý mọi trường hợp ngoại lệ có thể xảy ra.