Виконайте очищення до або під час операції Mail Merge

Aspose.Words дозволяє застосовувати різні параметри очищення та видалення, такі як видалення полів об’єднання перед виконанням операції Mail Merge або видалення невикористаних областей під час операції Mail Merge. У цьому розділі пояснюється, як видалити об’єднані поля та як налаштувати параметр видалення.

Видалення об’єднаних полів

Коли ви використовуєте будь-який довгий шаблон, створений кимось іншим, можливо, ви захочете видалити всі поля злиття, які вже існують у цьому шаблоні, перш ніж виконувати операцію Mail Merge. Ви можете використовувати метод DeleteFields, якщо хочете видалити всі Комбіновані поля з документа без виконання операції Mail Merge. На цей метод не впливають жодні параметри видалення властивості CleanupOptions, і при його виконанні видаляються лише Комбіновані поля, а не будь-які поля, що містять, або порожні абзаци.

Наступний приклад коду показує, як видалити всі поля злиття з вашого шаблону без виконання операції Mail Merge:

Встановіть параметр Removing

Aspose.Words дозволяє видаляти непоєднані поля, області та абзаци з шаблону під час операції Mail Merge за допомогою параметрів видалення.

Використовуйте властивість CleanupOptions разом з перерахуванням MailMergeCleanupOptions, щоб задати параметр видалення. Вкажіть, які елементи ви хочете видалити, вибравши наступні параметри (ви можете комбінувати кілька).:

• Видалити порожні абзаци
• Видалення невикористовуваних областей
• Видалення невикористовуваних полів
• Видалити містять поля
• Видалення статичних полів
• Видалення порожніх рядків таблиці

Поле злиття можна вважати непоєднаним при виконанні однієї з наступних умов:

1. Якщо поле злиття у джерелі даних не містить стовпця або поля відображення.
2. Якщо поле злиття у джерелі даних містить поле відображення, але дані мають значення null.

Якщо ви об’єднуєте дані, використовуючи окремі джерела даних, то ці параметри видалення будуть включені тільки при останньому виклику методу Mail Merge execute.

Видалити порожні абзаци

Абзац, що містить лише поля для об’єднання, буде порожнім, якщо процес Mail Merge видалить усі поля для об’єднання як не об’єднані. Ці порожні абзаци можуть додати непотрібного простору і змінити зовнішній вигляд Згенерованого звіту. При роботі з абзацами в процесі Mail Merge можуть виникнути дві ситуації:

1. Поле Mail Merge буде об’єднано з порожніми даними.
2. Поле для об’єднання не використовується і буде видалено.

В обох випадках опція RemoveEmptyParagraphs автоматично видалить порожні абзаци з документа. Крім того, вона видалить поля TableStart та TableEnd для об’єднання, якщо решта абзацу порожня.

Наступний приклад коду показує, як видалити порожні абзаци:

Ви можете завантажити приклад файлу цього прикладу з сайту Aspose.Words GitHub.

Видалення невикористовуваних областей

У попередніх версіях Aspose.Words порожні Mail Merge області автоматично видалялися з документа під час операції Mail Merge. В останній версії Aspose.words порожні Mail Merge області за замовчуванням залишаються після операції Mail Merge. Однак ви можете використовувати параметр RemoveUnusedRegions для видалення невикористаних областей Mail Merge під час операції Mail Merge. Наприклад, ви можете об’єднати документ із порожнім джерелом даних, що не містить таблиць даних, які призводять до невикористаних областей у документі.

Наступний приклад коду показує, як видалити невикористані області злиття:

Ви можете завантажити приклад файлу цього прикладу з сайту Aspose.Words GitHub.

Примітка

Видалення невикористовуваних полів

Aspose.Words дозволяє видалити всі невикористані Mail Merge поля, присвоївши прапору RemoveUnusedFields значення CleanupOptions. Цей параметр дозволяє видалити Комбіновані поля, які не містять відповідних даних у джерелі даних.

Наступний приклад коду показує, як автоматично видалити всі невикористані поля злиття з документа під час операції Mail Merge:

Видалення містять полів

Поле для об’єднання може міститися всередині іншого поля, такого як поле IF або поле формули. Видаліть це зовнішнє поле, коли поле для об’єднання буде об’єднано або видалено з документа.

Наступний приклад коду показує, як видалити поля, що містять поля злиття, з документа:

Примітка

Видалення порожніх рядків таблиці

Aspose.Words дозволяє видаляти порожні рядки таблиці, присвоївши прапору RemoveEmptyTableRows значення CleanupOptions. Цей параметр дозволяє видаляти рядки таблиці, що містять порожні поля злиття.

Наступний приклад коду показує, як видалити порожні рядки таблиці, що містять області Mail Merge, з документа: