Tentukan Opsi Muat

Saat memuat dokumen, Anda dapat mengatur beberapa properti lanjutan. Aspose.Words memberi Anda kelas LoadOptions, yang memungkinkan kontrol proses pemuatan yang lebih tepat. Beberapa format pemuatan memiliki kelas terkait yang berisi opsi pemuatan untuk format pemuatan ini, misalnya, ada PdfLoadOptions untuk memuat ke format PDF atau TxtLoadOptions untuk memuat ke TXT. Artikel ini memberikan contoh bekerja dengan opsi kelas LoadOptions.

Atur Versi Microsoft Word untuk Mengubah Tampilan

Versi aplikasi Microsoft Word yang berbeda dapat menampilkan dokumen dengan cara yang berbeda. Misalnya, ada masalah umum dengan dokumen OOXML seperti DOCX atau DOTX yang dibuat menggunakan WPS Office. Dalam hal ini, elemen markup dokumen penting mungkin hilang atau ditafsirkan berbeda sehingga menyebabkan Microsoft Word 2019 menampilkan dokumen tersebut secara berbeda dibandingkan dengan Microsoft Word 2010.

Secara default Aspose.Words membuka dokumen menggunakan aturan Microsoft Word 2019. Jika Anda perlu membuat pemuatan dokumen tampak seperti yang terjadi di salah satu versi aplikasi Microsoft Word sebelumnya, Anda harus secara eksplisit menentukan versi yang diinginkan menggunakan properti MswVersion kelas LoadOptions.

Contoh kode berikut menunjukkan cara mengatur versi Microsoft Word dengan opsi pemuatan:

Atur Preferensi Bahasa untuk Mengubah Tampilan

Detail tampilan dokumen di Microsoft Word tidak hanya bergantung pada versi aplikasi dan nilai properti MswVersion tetapi juga pada pengaturan bahasa. Microsoft Word mungkin menampilkan dokumen secara berbeda tergantung pada pengaturan dialog “Preferensi Bahasa Office”, yang dapat ditemukan di “File → Opsi → Bahasa”. Dengan menggunakan dialog ini pengguna dapat memilih, misalnya, bahasa utama, bahasa pemeriksaan, bahasa tampilan, dan sebagainya. Aspose.Words menyediakan properti LanguagePreferences yang setara dengan dialog ini. Jika keluaran Aspose.Words berbeda dengan keluaran Microsoft Word, tetapkan nilai yang sesuai untuk EditingLanguage – ini dapat meningkatkan kualitas dokumen keluaran.

Contoh kode berikut menunjukkan cara menyetel bahasa Jepang sebagai EditingLanguage:

Gunakan WarningCallback untuk Mengontrol Masalah Saat Memuat Dokumen

Beberapa dokumen mungkin rusak, berisi entri yang tidak valid, atau memiliki fitur yang saat ini tidak didukung oleh Aspose.Words. Jika Anda ingin mengetahui masalah yang terjadi saat memuat dokumen, Aspose.Words menyediakan antarmuka IWarningCallback.

Contoh kode berikut menunjukkan implementasi antarmuka IWarningCallback:

Untuk mendapatkan informasi tentang semua masalah sepanjang waktu buka, gunakan properti WarningCallback.

Contoh kode berikut menunjukkan cara menggunakan properti ini:

Gunakan ResourceLoadingCallback untuk Mengontrol Pemuatan Sumber Daya Eksternal

Sebuah dokumen mungkin berisi tautan eksternal ke gambar yang terletak di suatu tempat di disk lokal, jaringan, atau Internet. Aspose.Words secara otomatis memuat gambar tersebut ke dalam dokumen, tetapi ada situasi ketika proses ini perlu dikontrol. Misalnya, untuk memutuskan apakah kita benar-benar perlu memuat gambar tertentu atau mungkin melewatkannya. Opsi pemuatan ResourceLoadingCallback memungkinkan Anda mengontrol ini.

Contoh kode berikut menunjukkan implementasi antarmuka IResourceLoadingCallback:

Contoh kode berikut menunjukkan cara menggunakan properti ResourceLoadingCallback:

Gunakan TempFolder untuk Menghindari Pengecualian Memori

Aspose.Words mendukung dokumen berukuran sangat besar yang memiliki ribuan halaman penuh dengan konten yang kaya. Memuat dokumen seperti itu mungkin memerlukan banyak RAM. Dalam proses memuat, Aspose.Words memerlukan lebih banyak memori untuk menampung struktur sementara yang digunakan untuk mengurai dokumen.

Jika Anda mengalami masalah dengan pengecualian Kehabisan Memori saat memuat dokumen, coba gunakan properti TempFolder. Dalam hal ini, Aspose.Words akan menyimpan beberapa data dalam file sementara, bukan di memori, dan ini dapat membantu menghindari pengecualian tersebut.

Contoh kode berikut menunjukkan cara mengatur TempFolder:

Atur Pengkodean Secara Eksplisit

Kebanyakan format dokumen modern menyimpan kontennya dalam Unicode dan tidak memerlukan penanganan khusus. Di sisi lain, masih banyak dokumen yang menggunakan pengkodean pra-Unicode dan terkadang kehilangan informasi pengkodean atau bahkan tidak mendukung pengkodean informasi secara alami. Aspose.Words mencoba mendeteksi secara otomatis pengkodean yang sesuai secara default, namun dalam kasus yang jarang terjadi, Anda mungkin perlu menggunakan pengkodean yang berbeda dari yang terdeteksi oleh algoritma pengenalan pengkodean kami. Dalam hal ini, gunakan properti Encoding untuk mendapatkan atau menyetel pengkodean.

Contoh kode berikut menunjukkan cara mengatur pengkodean untuk menggantikan pengkodean yang dipilih secara otomatis:

Muat Dokumen Terenkripsi

Anda dapat memuat dokumen Word yang dienkripsi dengan kata sandi. Untuk melakukan ini, gunakan kelebihan konstruktor khusus, yang menerima objek LoadOptions. Objek ini berisi properti Password, yang menentukan string kata sandi.

Contoh kode berikut menunjukkan cara memuat dokumen yang dienkripsi dengan kata sandi:

Jika Anda tidak mengetahui sebelumnya apakah file dienkripsi, Anda dapat menggunakan kelas FileFormatUtil, yang menyediakan metode utilitas untuk bekerja dengan format file, seperti mendeteksi format file atau mengonversi ekstensi file ke/dari enumerasi format file. Untuk mendeteksi apakah dokumen dienkripsi dan memerlukan kata sandi untuk membukanya, gunakan properti IsEncrypted.

Contoh kode berikut menunjukkan cara memverifikasi OpenDocument apakah terenkripsi atau tidak: