Оновити поля

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

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

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

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

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

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

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

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

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

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

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

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

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

W:dirty є атрибутом рівня поля, який освіжає тільки поле, яку ви вказали при відкритті документа. Розповсюджує MS Word лише освіжаючи цей поле наступного разу, коли відкривається документ. Ви можете використовувати LoadOptions.setUpdateDirtyFields() майно, щоб вказати, чи оновити поля з атрибутом брудної маси. Коли значення LoadOptions.setUpdateDirtyFields() встановлюється для true > всі поля, які мають true значення для Field.IsDirty або FieldChar.IsDirty майно оновлено на документі навантаження

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

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

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

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