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:

BuiltInDocumentProperties dan CustomDocumentProperties adalah kumpulan objek DocumentProperty. Objek-objek ini dapat diperoleh melalui properti pengindeks berdasarkan nama atau indeks.

BuiltInDocumentProperties juga menyediakan akses ke properti dokumen melalui sekumpulan properti yang dimasukkan yang mengembalikan nilai dari tipe yang sesuai. CustomDocumentProperties 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 DocumentProperty.ToXXX, seperti DocumentProperty.ToString dan DocumentProperty.ToInt, 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”.

bekerja-dengan-properti-dokumen-1.png

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 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 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 UpdateWordCount untuk menghitung ulang dan memperbarui properti berikut:

Buat Properti Kustom Baru yang Tertaut 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:

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 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:

Konversi Antar Unit Pengukuran di C#