Оновити поля

Зазвичай поле вставляється в Microsoft Word вже містить значення дати. Наприклад, якщо поле є формулою або номером сторінки, вона міститиме правильне розрахункове значення для даної версії документа. Але якщо у вас є програма, яка генерує або модіфікує документ з полями, такими як злиття двох документів або поширення його з даними, то ідеально всі поля повинні оновлюватися для документа, щоб бути корисними.

Як оновити поля

Коли документ завантажується, Aspose.Words імітує поведінку Microsoft Word з можливістю автоматичного оновлення поля вимкнено. Поведінка може бути узагальнена наступним чином:

  • при відкритті/Зберегти документ поля залишаються неактуальними
  • Ви можете явно оновити всі поля в документі (наприклад, перебудувати TOC) коли вам потрібно
  • при друку/відправленні до PDF або XPS Оновлено поля, пов’язані з сторінками-обчисленням в заголовках/футах
  • при виконанні mail merge всі поля автоматично оновлюються

Програма оновлень поля

Щоб явно оновити поля у всьому документі, просто зателефонуйте update_fieldsй Щоб оновити поля, що містяться в частині документа, отримуйте Range об’єкт і виклик update_fields метод. У Aspose.Words, Ви можете отримати Range для будь-якого вузла в дереві документа, такі як Section, HeaderFooter, Paragraph, і т.д. за допомогою Node.range майно. Ви можете оновити результат одного поля за допомогою виклику update метод.

Автоматичне оновлення полірованих полів під час торгівлі

Коли ви виконуєте перетворення документа на фіксований формат сторінки, наприклад, в PDF або XPS, потім Aspose.Words автоматично оновлювати поля макета сторінок PAGE, PAGEREF знайдені в заголовках / футерах документа. Ця поведінка імітує поведінку Microsoft Word при друку документа.

Якщо ви хочете оновити всі інші поля в документі, то вам потрібно викликати update_fields перед отриманням документа.

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

Автоматичне оновлення поля під час Mail Merge

Коли ви виконуєте <span notrans="<span notrans=" mail merge"="">, > всі поля в документі будуть автоматично оновлені. Це тому, що mail merge є випадок оновлення поля. Програма зустрічає mail merge поле і потрібно оновити результат, який передбачає захоплення значення з джерела даних і вставку його в поле. Логіка звичайно складна, наприклад, при закінчення документа/mail merge Регіон досягається, але є ще подальші дані, які повинні бути об’єднані, тоді регіон повинен бути дублікований і новий набір полів оновлено.

Update Fields Having Брудна Атрибут

W:dirty є атрибутом рівня поля, який освіжає тільки поле, яку ви вказали при відкритті документа. Він розповідає про MS Word лише освіжаючи цей поле наступного разу, коли відкривається документ. Ви можете використовувати update_dirty_fields властивість вказати, чи оновлювати поля з атрибутом брудної. Коли значення значення Статус на сервери Увійти <span notrans="<span notrans=" True"="">, > всі поля, які мають True значення для Field.is_dirty або FieldChar.is_dirty майно оновлено на документі навантаження.

Приклад наступного коду показує, як оновити поля, які мають атрибут брудних речовин:

Оновити LastSavedTime нерухомість до заощадження

Ви можете використовувати SaveOptions.update_last_saved_time_property майно, чи оновити відповідну вбудовану власність документа last_saved_time при збереженні документа.

Приклад коду показує, як оновити цю властивість: