Perbarui Bidang

Biasanya, bidang yang disisipkan ke Microsoft Word sudah berisi nilai terbaru. Misalnya, jika bidangnya adalah rumus atau nomor halaman, bidang tersebut akan berisi nilai terhitung yang benar untuk versi dokumen yang diberikan. Tetapi jika Anda memiliki aplikasi yang membuat atau memodifikasi dokumen dengan bidang seperti menggabungkan dua dokumen atau mengisinya dengan data, maka idealnya semua bidang harus diperbarui agar dokumen tersebut berguna.

Cara Memperbarui Bidang

Saat dokumen dimuat, Aspose.Words meniru perilaku Microsoft Word dengan opsi untuk memperbarui bidang secara otomatis dimatikan. Perilaku tersebut dapat diringkas sebagai berikut:

• saat Anda membuka / menyimpan dokumen, bidang tetap utuh
• anda dapat memperbarui semua bidang dalam dokumen secara eksplisit, misalnya, membangun kembali TOC saat Anda membutuhkannya
• saat Anda mencetak / merender ke PDF atau XPS, bidang yang terkait dengan penomoran halaman di header / footer diperbarui
• saat Anda menjalankan Mail Merge semua bidang diperbarui secara otomatis

Perbarui Bidang secara Terprogram

Untuk memperbarui bidang secara eksplisit di seluruh dokumen, cukup panggil metode UpdateFields. Untuk memperbarui bidang yang terdapat di bagian dokumen, dapatkan objek Range dan panggil metode UpdateFields. Di Aspose.Words, Anda dapat memperoleh Range untuk simpul apa pun di pohon dokumen, seperti Section, HeaderFooter, Paragraph, dll. menggunakan properti GetRange. Anda dapat memperbarui hasil dari satu bidang dengan memanggil metode Update.

Pembaruan Otomatis Bidang Terkait Halaman selama Rendering

Saat Anda menjalankan konversi dokumen ke format halaman tetap, mis. ke PDF atau XPS, maka Aspose.Words akan secara otomatis memperbarui bidang terkait tata letak halaman PAGE, PAGEREF yang terdapat di header / footer dokumen. Perilaku ini meniru perilaku Microsoft Word saat mencetak dokumen.

Jika Anda ingin memperbarui semua bidang lain dalam dokumen, maka Anda perlu memanggil UpdateFields sebelum merender dokumen.

Contoh berikut menunjukkan cara memperbarui semua bidang sebelum merender dokumen:

Pembaruan Bidang Otomatis selama Mail Merge

Saat Anda menjalankan mail merge, semua bidang dalam dokumen akan diperbarui secara otomatis. Ini karena Mail Merge adalah kasus pembaruan bidang. Program menemukan bidang Mail Merge dan perlu memperbarui hasilnya, yang melibatkan pengambilan nilai dari sumber data dan memasukkannya ke dalam bidang. Logikanya, tentu saja, lebih rumit, misalnya, ketika akhir wilayah document / mail merge tercapai tetapi masih ada data lebih lanjut yang akan digabungkan, maka wilayah tersebut perlu diduplikasi dan kumpulan bidang baru diperbarui.

Perbarui Bidang yang memiliki Atribut Kotor

W: dirty adalah atribut tingkat bidang yang hanya akan menyegarkan bidang yang Anda tentukan saat dokumen dibuka. Ini memberitahu MS Word untuk hanya menyegarkan bidang ini saat dokumen dibuka lagi. Anda dapat menggunakan LoadOptions.properti setUpdateDirtyFields() untuk menentukan apakah akan memperbarui bidang dengan atribut dirty. Ketika nilai dari LoadOptions.setUpdateDirtyFields () disetel ke true, semua bidang yang memiliki nilai true untuk properti Field.IsDirty atau FieldChar.IsDirty diperbarui saat dokumen dimuat.

Contoh kode berikut menunjukkan cara memperbarui bidang yang memiliki atribut dirty:

Perbarui properti LastSavedTime sebelum menyimpan

Anda dapat menggunakan properti UpdateLastSavedTimeProperty apakah akan memperbarui properti dokumen bawaan yang sesuai LastSavedTime saat menyimpan dokumen.

Contoh kode berikut menunjukkan cara memperbarui properti ini: