Генерация документов на C# с помощью Mail Merge

Wordize for .NET - профессиональное решение для автоматизированного создания персонализированных документов с использованием технологии Mail Merge. Класс MailMerger позволит C# разработчикам объединять готовые шаблоны документов с данными из различных источников для массовой генерации персонализированных счетов, договоров, отчетов и писем.

Wordize for .NET предоставляет возможность использовать технологию Mail Merge с шаблонами в любых поддерживаемых форматах: Word, PDF, HTML, Markdown и других. Это позволяет создавать персонализированные документы независимо от исходного формата шаблона.

Функциональные возможности:

Простое заполнение документов - метод Execute() генерирует персонализированные документы, объединяя готовые шаблоны с внешними источниками данных
Генерация динамического контента - метод ExecuteWithRegions() обрабатывает повторяющиеся элементы шаблона для создания таблиц и списков переменной длины
Интеграция с различными источниками данных - поддержка типов DataRow, DataTable, DataSet, массивов значений
Расширенные настройки - класс MailMergeOptions управляет параметрами генерации документов: удалением пустых абзацев, неиспользуемых регионов и полей, обрезкой лишних пробелов, объединением дублирующихся регионов и другими параметрами
Возможность экспорта результата в графический формат - метод ExecuteToImages() возвращает результат в виде набора изображений
Поддержка Fluent API для запуска генерации через MailMergerContext и цепочку методов, что добавляет C# коду наглядности

Сценарии использования:

Массовая рассылка персонализированных писем и уведомлений с индивидуальными данными получателей
Создание персонализированных счетов, договоров и предложений с информацией, специфичной для каждого клиента
Генерация документов по готовым формам: сертификаты, справки, приглашения с персональными данными
Автоматизированное создание однотипных документов с различным содержимым на основе баз данных

Протестируйте возможности программной генерации персонализированных документов с использованием технологии Mail Merge в интерактивном онлайн-демо, которое представлено на этой странице. Для этого загрузите шаблон документа, текстовый файл с данными (CSV, JSON, XML), запустите операцию и скачайте полученный результат на проверку. Представленный фрагмент кода C# полностью готов для использования в вашем .NET проекте.

Запустить код

Загрузите шаблон документа

Загрузите источник данных

Выберите формат вывода из списка

 
				
				
		
using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;

string json = File.ReadAllText("DataSource.json");
DataTable dataTable = JsonConvert.DeserializeObject(json);
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataTable);

										using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;

string json = File.ReadAllText("{{input2}}");
DataTable dataTable = JsonConvert.DeserializeObject(json);
MailMerger.Execute("{{input1}}", "{{output}}", SaveFormat.{{saveFormat}}, dataTable);

										using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;
using Wordize.Saving;

string json = File.ReadAllText("{{input2}}");
DataTable dataTable = JsonConvert.DeserializeObject(json);
var imageStreams = MailMerger.Execute("{{input1}}", new ImageSaveOptions(SaveFormat.{{saveFormat}}),  dataTable);

foreach (var (stream, page) in imageStreams.Select((s, i) => (s, i)))
{
    using var _ = stream;
    stream.Position = 0;
    
    using var file = File.Create($"Output_{page + 1}.{{outputExt}}");
    stream.CopyTo(file);
}

					
using System.Data;
using Wordize.MailMerging;

DataSet dataSet = new DataSet();
dataSet.ReadXml("DataSource.json");
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataSet.Tables[0]);

										using System.Data;
using Wordize.MailMerging;

DataSet dataSet = new DataSet();
dataSet.ReadXml("{{input2}}");
MailMerger.Execute("{{input1}}", "{{output}}", SaveFormat.{{saveFormat}}, dataSet.Tables[0]);

										using System.Data;
using Wordize.MailMerging;
using Wordize.Saving;

DataSet dataSet = new DataSet();
dataSet.ReadXml("{{input2}}");
var imageStreams = MailMerger.Execute("{{input1}}", new ImageSaveOptions(SaveFormat.{{saveFormat}}),  dataSet.Tables[0]);

foreach (var (stream, page) in imageStreams.Select((s, i) => (s, i)))
{
    using var _ = stream;
    stream.Position = 0;
    
    using var file = File.Create($"Output_{page + 1}.{{outputExt}}");
    stream.CopyTo(file);
}

					

                    Запустить код
			

Как генерировать персонализированные документы на C#

Подключите Wordize for .NET к своему C# проекту
Прочитайте файл с данными, десериализуйте их в DataTable и вызовите Execute(), указав шаблон документа, выходной файл, формат сохранения и источник данных
Получите сгенерированные персонализированные документы