Cara Bekerja dengan Pengaturan Dokumen di .NET
Panduan ini menunjukkan cara bekerja dengan pengaturan dokumen tingkat aplikasi di Aspose.Words FOSS untuk .NET: saklar kompatibilitas warisan, preferensi hyphenation, konfigurasi mail-merge yang disimpan, opsi tampilan, dan perlindungan penulisan. Aspose.Words FOSS untuk .NET tersedia melalui NuGet atau dengan membangun dari sumber.
Panduan Langkah-demi-Langkah
Langkah 1: Dapatkan Perpustakaan
Klon repositori dan bangun Aspose.Words.sln dalam konfigurasi Release, lalu tambahkan referensi proyek ke Aspose.Words.csproj dari proyek .NET Anda sendiri, seperti dijelaskan dalam Panduan Instalasi. Tambahkan using Aspose.Words; and using Aspose.Words.Settings; di bagian atas file apa pun yang membaca atau menulis pengaturan dokumen.
Langkah 2: Atur Opsi Kompatibilitas Warisan
Document.CompatibilityOptions (sebuah instance CompatibilityOptions) menyimpan puluhan saklar boolean yang meniru perilaku tata letak dan spasi Word versi lama — misalnya GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, dan SpacingInWholePoints. Atur properti individual yang Anda butuhkan secara langsung; OptimizeFor(MsWordVersion) ada pada kelas tetapi melempar NotImplementedException dalam build ini, sehingga tidak ada pintasan yang menerapkan seluruh profil versi sekaligus.
Langkah 3: Konfigurasikan Preferensi Pemenggalan Kata
Document.HyphenationOptions (sebuah instance HyphenationOptions) menyimpan preferensi hyphenation Word untuk dokumen: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, dan HyphenationZone. Properti-properti ini melakukan round-trip permintaan dalam file yang disimpan; karena edisi ini tidak memiliki mesin page-layout, pemenggalan hyphenation dihitung oleh Word saat membuka dan memaginasi file, bukan oleh Aspose.Words FOSS.
Langkah 4: Baca dan Tulis Konfigurasi Mail-Merge
Document.MailMergeSettings (sebuah instance MailMergeSettings) menyimpan konfigurasi mail-merge yang tercatat dalam dokumen — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, dan ViewMergedData — serta Clear() dan Clone(). Untuk sumber data eksternal yang terhubung melalui mekanisme Office Data Source Object milik Word, MailMergeSettings.Odso mengekspos sebuah instance Odso (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames), yang koleksi FieldMapDatas dan RecipientDatas-nya menjelaskan pemetaan bidang dan daftar penerima. Membaca dan menulis konfigurasi yang disimpan ini tersedia dalam edisi sumber terbuka ini; menjalankan merge itu sendiri terhadap sumber data langsung merupakan hal terpisah di luar ruang lingkup halaman ini.
Langkah 5: Konfigurasikan Pengaturan Tampilan Dokumen
Document.ViewOptions (sebuah instance ViewOptions) mengontrol cara Word menampilkan file setelah dibuka: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, dan FormsDesign. Properti-properti ini adalah preferensi yang disimpan yang hanya memengaruhi tampilan Word terhadap dokumen — mereka tidak berpengaruh pada cara Aspose.Words FOSS memprosesnya.
Langkah 6: Terapkan Proteksi Penulisan
Document.WriteProtection (sebuah instance WriteProtection) mengekspos IsWriteProtected dan ReadOnlyRecommended, dengan SetPassword() untuk menetapkan kata sandi proteksi dan ValidatePassword() untuk memeriksa kata sandi kandidat terhadapnya. Panggil SetPassword() sebelum menyetel IsWriteProtected = true, dan gunakan ValidatePassword() alih-alih menyimpan atau membandingkan string kata sandi mentah secara manual.
Masalah Umum dan Solusinya
CompatibilityOptions.OptimizeFor() throws NotImplementedException. Metode ini tidak diimplementasikan dalam build ini. Atur CompatibilityOptions properti boolean yang Anda perlukan secara langsung sebagai gantinya.
Changing ViewOptions.ZoomPercent tidak memiliki efek yang terlihat pada output yang dihasilkan. ViewOptions adalah preferensi tampilan yang disimpan dan dibaca oleh Word, bukan sesuatu yang diterapkan oleh Aspose.Words FOSS itu sendiri selama pemrosesan. Tidak perlu perbaikan — ini diharapkan.
WriteProtection.ValidatePassword() secara tak terduga mengembalikan false. SetPassword() tidak pernah dipanggil, atau kata sandi yang berbeda telah disetel. Panggil SetPassword() lebih dulu untuk menetapkan kata sandi terlindungi sebelum memvalidasi.
Konfigurasi mail-merge disimpan tetapi proses penggabungan tidak dijalankan. MailMergeSettings and Odso menyimpan hanya konfigurasi penggabungan; edisi sumber terbuka ini tidak mengeksekusi penggabungan itu sendiri. Baca konfigurasi yang disimpan dan jalankan logika pengisian bidang Anda sendiri berdasarkan itu.
Pertanyaan yang Sering Diajukan
Apakah CompatibilityOptions.OptimizeFor() berfungsi?
Tidak — ini melempar NotImplementedException dalam build ini. Atur properti CompatibilityOptions individu yang Anda perlukan secara langsung.
Bagaimana cara memproteksi dokumen dengan kata sandi agar tidak dapat diedit?
Panggil WriteProtection.SetPassword() pada Document.WriteProtection, lalu atur IsWriteProtected untuk mengaktifkan perlindungan.
Apakah HyphenationOptions dan ViewOptions mengubah tampilan dokumen ketika Aspose.Words FOSS memprosesnya?
Tidak. Keduanya adalah preferensi yang disimpan yang diterapkan oleh Word sendiri saat membuka dan menampilkan file; edisi ini tidak memiliki mesin tata letak halaman untuk menanganinya secara langsung.
Di mana saya dapat menemukan konfigurasi sumber data mail-merge untuk sumber data eksternal?
MailMergeSettings.Odso — koleksi FieldMapDatas dan RecipientDatasnya menjelaskan pemetaan kolom dan status inklusi penerima.
Apa perbedaan antara Document.CompatibilityOptions dan Document.ViewOptions?
CompatibilityOptions switches menghasilkan tata letak dan keanehan spasi Word lama; ViewOptions mengontrol bagaimana antarmuka Word menampilkan berkas (pembesaran, tanda format). Keduanya tidak dihitung oleh Aspose.Words FOSS itu sendiri.
