Bekerja dengan Properti Dokumen
Properti dokumen memungkinkan penyimpanan beberapa informasi berguna tentang dokumen Anda. Properti ini dapat dibagi menjadi dua kelompok:
- Sistem atau built-in 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.
Berguna untuk mengetahui bahwa informasi tentang API dan Nomor Versi langsung ditulis ke dokumen keluaran. Misalnya, saat mengonversi dokumen menjadi PDF, Aspose.Words mengisi bidang “Aplikasi” dengan “Aspose.Words”, dan bidang “ProduserPDF” dengan “Aspose.Words untuk C++ YY.M. N”, di mana YY.M.N adalah versi Aspose.Words yang digunakan untuk konversi. Untuk lebih jelasnya, lihat Generator atau Nama Produsen yang Disertakan dalam Dokumen Keluaran.
Mengakses Properti Dokumen
Untuk mengakses properti dokumen dalam Aspose.Words gunakan:
-
BuiltInDocumentProperties untuk mendapatkan properti bawaan.
-
CustomDocumentProperties untuk mendapatkan properti khusus.
BuiltInDocumentProperties
BuiltInDocumentProperties
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 jenis propertinya, Anda dapat menggunakan salah satu metode DocumentProperty.ToXXX, seperti DocumentProperty. ToString dan DocumentProperty. ToInt, untuk mendapatkan nilai dari tipe yang sesuai.
Contoh kode berikut menunjukkan cara menghitung semua properti bawaan dan properti khusus dalam dokumen:
Di Microsoft Word, Anda dapat mengakses properti dokumen menggunakan menu “File → Properties”.
Menambah atau Menghapus 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, berikan nama properti baru dan nilai dari tipe yang sesuai. Metode mengembalikan objek DocumentProperty yang baru dibuat.
Untuk menghapus properti khusus, gunakan metode Remove, berikan nama properti untuk dihapus, atau metode RemoveAt 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 di dokumen dan menambahkan beberapa properti dokumen kustom lainnya:
Contoh kode berikut menunjukkan cara menghapus properti dokumen khusus:
Perbarui properti Dokumen bawaan
Aspose.Words tidak memperbarui properti dokumen secara otomatis, seperti yang dilakukan Microsoft Word dengan beberapa properti, tetapi menyediakan metode untuk memperbarui beberapa properti dokumen bawaan statistik. Panggil metode UpdateWordCount untuk menghitung ulang dan memperbarui properti berikut:
Buat Properti Kustom Baru yang Ditautkan ke Konten
Aspose.Words menyediakan metode AddLinkToContent untuk membuat properti dokumen kustom baru yang ditautkan ke konten. Properti ini mengembalikan objek properti yang baru dibuat atau null jika LinkSource 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 menghitung variabel dokumen:
Menghapus 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 melakukannya, gunakan properti RemovePersonalInformation 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: