Cập nhật trường
Thông thường, trường được chèn vào Microsoft Word đã chứa giá trị cập nhật. Ví dụ: nếu trường là công thức hoặc số trang, nó sẽ chứa giá trị được tính toán chính xác cho phiên bản đã cho của tài liệu. Nhưng nếu bạn có một ứng dụng tạo hoặc sửa đổi tài liệu với các trường như hợp nhất hai tài liệu hoặc điền dữ liệu vào đó, thì lý tưởng nhất là tất cả các trường phải được cập nhật để tài liệu trở nên hữu ích.
Cách cập nhật trường
Khi một tài liệu được tải, Aspose.Words bắt chước hành vi của Microsoft Word với tùy chọn tự động cập nhật các trường bị tắt. Hành vi này có thể được tóm tắt như sau:
- khi bạn mở/lưu tài liệu, các trường vẫn còn nguyên
- bạn có thể cập nhật rõ ràng tất cả các trường trong tài liệu (ví dụ: xây dựng lại TOC) khi bạn cần
- khi bạn in/kết xuất sang PDF hoặc XPS, các trường liên quan đến đánh số trang ở đầu trang/chân trang sẽ được cập nhật
- khi bạn thực thi mail merge, tất cả các trường sẽ được cập nhật tự động
Cập nhật các trường theo chương trình
Để cập nhật rõ ràng các trường trong toàn bộ tài liệu, chỉ cần gọi update_fields. Để cập nhật các trường có trong một phần của tài liệu, hãy lấy đối tượng Range và gọi phương thức update_fields. Trong Aspose.Words, bạn có thể lấy Range cho bất kỳ nút nào trong cây tài liệu, chẳng hạn như Section, HeaderFooter, Paragraph, v.v. bằng thuộc tính Node.range. Bạn có thể cập nhật kết quả của một trường bằng cách gọi phương thức update.
Tự động cập nhật các trường liên quan đến trang trong khi hiển thị
Khi bạn thực hiện chuyển đổi tài liệu sang định dạng trang cố định, ví dụ: sang PDF hoặc XPS, thì Aspose.Words sẽ tự động cập nhật các trường liên quan đến bố cục trang PAGE, PAGEREF được tìm thấy trong đầu trang/chân trang của tài liệu. Hành vi này bắt chước hành vi của Microsoft Word khi in tài liệu.
Nếu bạn muốn cập nhật tất cả các trường khác trong tài liệu thì bạn cần gọi update_fields trước khi hiển thị tài liệu.
Ví dụ mã sau đây cho biết cách cập nhật tất cả các trường trước khi hiển thị tài liệu:
Cập nhật trường tự động trong Mail Merge
Khi bạn thực thi mail merge, tất cả các trường trong tài liệu sẽ được cập nhật tự động. Điều này là do Mail Merge là một trường hợp cập nhật trường. Chương trình gặp trường Mail Merge và cần cập nhật kết quả của nó, bao gồm việc lấy giá trị từ nguồn dữ liệu và chèn nó vào trường. Tất nhiên, logic phức tạp hơn, chẳng hạn như khi đã đến cuối vùng tài liệu/mail merge nhưng vẫn còn dữ liệu tiếp theo cần được hợp nhất, thì vùng đó cần được sao chép và tập hợp trường mới được cập nhật.
Cập nhật các trường có thuộc tính bẩn
w:dirty là thuộc tính cấp trường sẽ chỉ làm mới trường bạn chỉ định khi tài liệu được mở. Nó yêu cầu MS Word chỉ làm mới trường này vào lần mở tài liệu tiếp theo. Bạn có thể sử dụng thuộc tính update_dirty_fields để chỉ định xem có cập nhật các trường có thuộc tính dirty hay không. Khi giá trị của update_dirty_fields được đặt thành True, tất cả các trường có giá trị True cho thuộc tính Field.is_dirty hoặc FieldChar.is_dirty sẽ được cập nhật khi tải tài liệu.
Ví dụ mã sau đây cho thấy cách cập nhật các trường có thuộc tính dirty:
Cập nhật thuộc tính LastSavedTime trước khi lưu
Bạn có thể sử dụng thuộc tính SaveOptions.update_last_saved_time_property để cập nhật thuộc tính tài liệu tích hợp tương ứng last_saved_time khi lưu tài liệu.
Ví dụ mã sau đây cho biết cách cập nhật thuộc tính này: