Tạo Word từ mẫu trong C#

Tự động hóa việc tạo tài liệu là điều cần thiết cho các doanh nghiệp nhằm tạo ra các báo cáo, hóa đơn và thư từ động. Với Aspose.Words Mail Merge cho .NET, bạn có thể điền dữ liệu vào các mẫu Word một cách hiệu quả từ nhiều nguồn khác nhau, bao gồm các đối tượng, CSV, JSON và XML. Hướng dẫn này sẽ hướng dẫn bạn cách sử dụng Mail Merge trong C# để tối ưu hóa và tự động hóa quy trình làm việc với tài liệu, tập trung vào việc tạo tài liệu Word động với C# .NET.

Các Chủ Đề Được Đề Cập:

Tổng Quan về Mail Merge cho .NET

Aspose.Words Mail Merge cho .NET cho phép các nhà phát triển tạo ra các tài liệu cá nhân hóa từ các mẫu đã được định nghĩa trước có chứa các trường hợp ghép. Plugin này được thiết kế để tích hợp liền mạch trong các môi trường .NET, cung cấp khả năng:

  • Điền động các mẫu bằng dữ liệu, hỗ trợ tạo tài liệu Word trong .NET framework.
  • Thực hiện tạo tài liệu hàng loạt một cách hiệu quả, tận dụng giải pháp mail merge .NET cho các tập dữ liệu lớn.
  • Đảm bảo định dạng nhất quán trên các đầu ra, nâng cao những thực hành tốt nhất cho mẫu tài liệu Word C#.

Các Tính Năng Chính:

  1. Hỗ Trợ Nhiều Nguồn: Sử dụng dữ liệu từ các đối tượng, cơ sở dữ liệu, XML, JSON và CSV để tạo tài liệu Word tùy chỉnh với C#.
  2. Hiệu Suất Cao: Xử lý hiệu quả các tập dữ liệu lớn và các thao tác hàng loạt cho việc tạo tài liệu Word động với .NET Core.
  3. Mẫu Tùy Chỉnh: Tạo các mẫu với các vị trí để chèn dữ liệu, tận dụng khả năng tự động hóa mail merge Word .NET.

Cài Đặt

Để bắt đầu, hãy cài đặt Aspose.Words bằng cách sử dụng NuGet:

PM> Install-Package Aspose.Words

Tạo Tài Liệu Word từ Mẫu Sử Dụng Đối Tượng C#

Hãy bắt đầu bằng cách điền một mẫu Word sử dụng các đối tượng C#. Chúng ta sẽ tạo một tài liệu Word (DOC/DOCX) với các vị trí sau:

<<[sender.Name]>> nói: "<<[sender.Message]>>."

Trong ví dụ này, sender là một thể hiện của một lớp mà chúng ta sẽ sử dụng để điền mẫu bằng cách sử dụng phương pháp C# tạo tài liệu Word từ cơ sở dữ liệu.

Tiếp theo, chúng ta sẽ sử dụng động cơ báo cáo của Aspose.Words để tạo tài liệu Word từ mẫu và thể hiện của lớp Sender bằng cách thực hiện các bước sau:

  1. Tạo một thể hiện của lớp Document và khởi tạo nó với đường dẫn của mẫu Word.
  2. Tạo và khởi tạo một đối tượng của lớp Sender.
  3. Khởi tạo lớp ReportingEngine.
  4. Điền mẫu bằng cách sử dụng ReportingEngine.BuildReport(), phương thức này nhận thể hiện của Document, nguồn dữ liệu và tên của nguồn dữ liệu làm tham số.
  5. Lưu tài liệu Word đã tạo bằng cách sử dụng Document.Save().

Dưới đây là mẫu mã minh họa cách tạo tài liệu Word từ một mẫu trong C#.

Kết Quả

Tạo Tài Liệu Word từ Nguồn Dữ Liệu XML trong C#

Để tạo tài liệu Word từ một nguồn dữ liệu XML, chúng ta sẽ sử dụng một mẫu Word phức tạp hơn với các vị trí sau:

<<foreach [in persons]>>Tên: <<[Name]>>, Tuổi: <<[Age]>>, Ngày sinh: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Tuổi trung bình: <<[persons.Average(p => p.Age)]>>

Nguồn dữ liệu XML được sử dụng trong ví dụ này được hiển thị dưới đây.

Để tạo một tài liệu Word từ một nguồn dữ liệu XML, hãy thực hiện các bước sau:

  1. Tạo một thể hiện của lớp Document và khởi tạo nó với đường dẫn của mẫu Word.
  2. Tạo một thể hiện của lớp XmlDataSource và khởi tạo nó với đường dẫn của tệp XML.
  3. Khởi tạo lớp ReportingEngine.
  4. Sử dụng phương thức ReportingEngine.BuildReport() để điền mẫu Word.
  5. Lưu tài liệu Word đã tạo bằng phương thức Document.Save().

Dưới đây là mẫu mã minh họa cách tạo tài liệu Word từ một nguồn dữ liệu XML trong C#.

Kết Quả

Tạo Tài Liệu Word từ Nguồn Dữ Liệu JSON trong C#

Tiếp theo, hãy khám phá cách tạo tài liệu Word sử dụng một nguồn dữ liệu JSON. Trong ví dụ này, chúng ta sẽ tạo một danh sách khách hàng phân loại theo các quản lý của họ. Mẫu Word sẽ trông như sau:

<<foreach [in managers]>>Quản lý: <<[Name]>>
Hợp đồng:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

Nguồn dữ liệu JSON tương ứng mà chúng ta sẽ sử dụng để điền mẫu như sau:

Để tạo tài liệu Word từ JSON, chúng ta sẽ sử dụng lớp JsonDataSource để tải nguồn dữ liệu, và các bước còn lại sẽ theo cấu trúc trước đó. Dưới đây là mẫu mã minh họa cách tạo tài liệu Word từ mẫu JSON trong C#.

Kết Quả

Tạo Tài Liệu Word từ Nguồn Dữ Liệu CSV trong C#

Để tạo tài liệu Word từ một nguồn CSV, chúng ta sẽ sử dụng mẫu Word sau:

<<foreach [in persons]>>Tên: <<[Column1]>>, Tuổi: <<[Column2]>>, Ngày sinh: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Tuổi trung bình: <<[persons.Average(p => p.Column2)]>>

Mẫu này sẽ được điền bằng dữ liệu CSV sau:

Bây giờ, hãy xem xét mã C#. Các bước vẫn giống nhau ngoại trừ một điểm khác biệt chính: chúng ta sẽ sử dụng lớp CsvDataSource để tải dữ liệu CSV. Mẫu mã sau minh họa cách tạo tài liệu Word từ nguồn dữ liệu CSV.

Kết Quả

Hãy Thử Aspose.Words cho .NET Miễn Phí

Bạn có thể thử Aspose.Words cho .NET bằng cách sử dụng giấy phép tạm thời miễn phí.

Kết Luận

Trong bài viết này, bạn đã học cách tạo tài liệu Word từ các mẫu bằng C#. Bạn đã khám phá cách tận dụng nhiều nguồn dữ liệu như các đối tượng, XML, JSON và CSV cho việc tạo tài liệu động trong .NET. Để biết thêm thông tin về khả năng của xử lý mẫu Word .NET, hãy tìm hiểu trong tài liệu, và đừng ngần ngại liên hệ với chúng tôi qua diễn đàn.

Xem Thêm