Виконайте очищення до або під час операції Mail Merge
Aspose.Words дозволяє застосовувати різні параметри очищення та видалення, такі як видалення полів об’єднання перед виконанням операції Mail Merge або видалення невикористаних областей під час операції Mail Merge. У цьому розділі пояснюється, як видалити об’єднані поля та як налаштувати параметр видалення.
Видалення об’єднаних полів
Коли ви використовуєте будь-який довгий шаблон, створений кимось іншим, можливо, ви захочете видалити всі поля злиття, які вже існують у цьому шаблоні, перш ніж виконувати операцію Mail Merge. Ви можете використовувати метод DeleteFields, якщо хочете видалити всі Комбіновані поля з документа без виконання операції Mail Merge. На цей метод не впливають жодні параметри видалення властивості CleanupOptions, і при його виконанні видаляються лише Комбіновані поля, а не будь-які поля, що містять, або порожні абзаци.
Наступний приклад коду показує, як видалити всі поля злиття з вашого шаблону без виконання операції Mail Merge:
Встановіть параметр Removing
Aspose.Words дозволяє видаляти непоєднані поля, області та абзаци з шаблону під час операції Mail Merge за допомогою параметрів видалення.
Використовуйте властивість CleanupOptions разом з перерахуванням MailMergeCleanupOptions, щоб задати параметр видалення. Вкажіть, які елементи ви хочете видалити, вибравши наступні параметри (ви можете комбінувати кілька).:
- Видалити порожні абзаци
- Видалення невикористовуваних областей
- Видалити невикористані поля
- Видалити містять поля
- Видалення статичних полів
- Видалення порожніх рядків таблиці
Поле злиття можна вважати непоєднаним при виконанні однієї з наступних умов:
- Якщо поле злиття у джерелі даних не містить стовпця або поля відображення.
- Якщо поле злиття у джерелі даних містить поле відображення, але дані мають значення null.
Видалити порожні абзаци
Абзац, що містить лише поля для об’єднання, буде порожнім, коли процес Mail Merge видалить усі поля для об’єднання як не об’єднані. Ці порожні абзаци можуть додати непотрібного простору і змінити зовнішній вигляд Згенерованого звіту. При роботі з абзацами в процесі Mail Merge можуть виникнути дві ситуації:
- Поле Mail Merge буде об’єднано з порожніми даними.
- Поле для об’єднання не використовується і буде видалено.
В обох випадках опція RemoveEmptyParagraphs автоматично видалить порожні абзаци з документа. Крім того, вона видалить поля TableStart та TableEnd для об’єднання, якщо решта абзацу порожня.
Наступний приклад коду показує, як видалити порожні абзаци:
Видалення невикористовуваних областей
У попередніх версіях Aspose.Words порожні Mail Merge області автоматично видалялися з документа під час операції Mail Merge. В останній версії Aspose.words порожні Mail Merge області залишаються після операції Mail Merge за замовчуванням. Однак ви можете використовувати параметр RemoveUnusedRegions для видалення невикористаних областей Mail Merge під час операції Mail Merge. Наприклад, ви можете об’єднати документ із порожнім джерелом даних, що не містить таблиць даних, які призводять до невикористаних областей у документі.
Наступний приклад коду показує, як видалити невикористані області злиття:
Примітка
Видалення невикористовуваних полів
Aspose.Words дозволяє видалити всі невикористані Mail Merge поля, присвоївши прапору RemoveUnusedFields значення CleanupOptions. Цей параметр дозволяє видалити Комбіновані поля, які не містять відповідних даних у джерелі даних.
Наступний приклад коду показує, як автоматично видалити всі невикористані поля злиття з документа під час операції Mail Merge:
Видалення містять полів
Комбіноване поле може міститися всередині іншого поля, такого як поле IF або поле формули. Видаліть це зовнішнє поле, коли об’єднане поле буде об’єднано або видалено з документа.
Наступний приклад коду показує, як видалити поля, що містять поля злиття, з документа:
Примітка
Видалення порожніх рядків таблиці
Aspose.Words дозволяє видаляти порожні рядки таблиці, присвоївши прапору RemoveEmptyTableRows значення CleanupOptions. Цей параметр дозволяє видаляти рядки таблиці, що містять порожні поля злиття.
Наступний приклад коду показує, як видалити порожні рядки таблиці, що містять області Mail Merge, з документа: