Bekerja dengan Properti Dokumen
Properti dokumen memungkinkan penyimpanan beberapa informasi berguna tentang dokumen Anda. Properti ini dapat dibagi menjadi dua kelompok:
- Sistem atau bawaan yang berisi nilai-nilai seperti judul dokumen, nama penulis, statistik dokumen, dan lain-lain.
- Ditentukan pengguna atau khusus, disediakan sebagai pasangan nama-nilai di mana pengguna dapat menentukan nama dan nilai.
Penting untuk mengetahui bahwa informasi tentang API dan Nomor Versi langsung ditulis ke dokumen keluaran. Misalnya, saat mengonversi dokumen ke PDF, Aspose.Words mengisi kolom “Aplikasi” dengan “Aspose.Words”, dan kolom “Produser PDF” dengan “Aspose.Words untuk .NET YY.MN”, dengan YY.M.N adalah versi Aspose.Words yang digunakan untuk konversi. Untuk detail selengkapnya, lihat Nama Generator atau Produser Dicantumkan dalam Dokumen Keluaran.
Akses Properti Dokumen
Untuk mengakses properti dokumen di Aspose.Words gunakan:
-
built_in_document_properties untuk mendapatkan properti bawaan.
-
custom_document_properties untuk mendapatkan properti khusus.
built_in_document_properties dan custom_document_properties adalah kumpulan objek DocumentProperty. Objek-objek ini dapat diperoleh melalui properti pengindeks berdasarkan nama atau indeks.
built_in_document_properties juga menyediakan akses ke properti dokumen melalui sekumpulan properti yang dimasukkan yang mengembalikan nilai dari tipe yang sesuai. custom_document_properties memungkinkan Anda menambah atau menghapus properti dokumen dari dokumen.
Kelas DocumentProperty memungkinkan Anda mendapatkan nama, nilai, dan tipe properti dokumen. value mengembalikan objek, tetapi ada serangkaian metode yang memungkinkan Anda mengonversi nilai properti ke tipe tertentu. Setelah Anda mengetahui tipe propertinya, Anda bisa menggunakan salah satu metode Properti Dokumen.to_XXX, seperti Properti Dokumen.__str__ dan DocumentProperty.to_int, untuk mendapatkan nilai tipe yang sesuai.
Contoh kode berikut menunjukkan cara menghitung semua properti bawaan dan kustom dalam dokumen:
Di Microsoft Word, Anda dapat mengakses properti dokumen menggunakan menu “File → Properties”.
Tambah atau Hapus Properti Dokumen
Anda tidak dapat menambah atau menghapus properti dokumen bawaan menggunakan Aspose.Words. Anda hanya dapat mengubah atau memperbarui nilainya.
Untuk menambahkan properti dokumen khusus dengan Aspose.Words, gunakan metode add, meneruskan nama properti baru dan nilai tipe yang sesuai. Metode ini mengembalikan objek DocumentProperty yang baru dibuat.
Untuk menghapus properti khusus, gunakan metode remove, berikan nama properti yang akan dihapus, atau metode remove_at untuk menghapus properti berdasarkan indeks. Anda juga dapat menghapus semua properti menggunakan metode clear.
Contoh kode berikut memeriksa apakah properti kustom dengan nama tertentu ada dalam dokumen dan menambahkan beberapa properti dokumen kustom lainnya:
Contoh kode berikut menunjukkan cara menghapus properti dokumen kustom:
Perbarui Properti Dokumen Bawaan
Aspose.Words tidak secara otomatis memperbarui properti dokumen, seperti yang dilakukan Microsoft Word dengan beberapa properti, namun menyediakan metode untuk memperbarui beberapa properti dokumen bawaan statistik. Panggil metode update_word_count untuk menghitung ulang dan memperbarui properti berikut:
Buat Properti Kustom Baru yang Tertaut ke Konten
Aspose.Words menyediakan metode add_link_to_content untuk membuat properti dokumen kustom baru yang ditautkan ke konten. Properti ini mengembalikan objek properti yang baru dibuat atau null jika tautan_sumber tidak valid.
Contoh kode berikut menunjukkan cara mengonfigurasi tautan ke properti khusus:
Dapatkan Variabel Dokumen
Anda bisa mendapatkan kumpulan variabel dokumen menggunakan properti variables. Nama dan nilai variabel adalah string.
Contoh kode berikut menunjukkan cara menambahkan dan mengakses variabel dokumen:
Hapus Informasi Pribadi dari Dokumen
Jika Anda ingin berbagi dokumen Word dengan orang lain, Anda mungkin ingin menghapus informasi pribadi seperti nama penulis dan perusahaan. Untuk melakukan hal ini gunakan properti remove_personal_information untuk menyetel tanda yang menunjukkan bahwa Microsoft Word akan menghapus semua informasi pengguna dari komentar, revisi, dan properti dokumen setelah menyimpan dokumen.
Contoh kode berikut menunjukkan cara menghapus informasi pribadi: