Bekerja dengan Pengaturan Dokumen

Bekerja dengan Pengaturan Dokumen

Selain konten, dokumen Word membawa pengaturan tingkat aplikasi – saklar kompatibilitas warisan, preferensi hyphenation, konfigurasi mail-merge yang disimpan, opsi tampilan, dan status perlindungan penulisan. Aspose.Words FOSS untuk .NET mengekspos ini melalui Aspose.Words.Settings namespace dan sejumlah properti pada Document. Halaman ini mencakup setiap grup pengaturan serta apa yang dikendalikan dan tidak dikendalikan olehnya.

Opsi Kompatibilitas

Document.CompatibilityOptions adalah sebuah instance CompatibilityOptions yang menyimpan puluhan saklar boolean yang meniru perilaku tata letak dan spasi khusus versi Word lama – misalnya GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout, dan BalanceSingleByteDoubleByteWidth. Atur properti yang Anda butuhkan secara langsung untuk mencocokkan keanehan rendering versi Word tertentu dalam perangkat lunak hilir yang membaca dokumen.

Preferensi Hyphenasi

Document.HyphenationOptions adalah sebuah instance HyphenationOptions (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone) yang menyimpan preferensi hyphenasi Word untuk dokumen. Properti-properti ini melakukan round-trip permintaan; karena edisi ini tidak menyertakan mesin tata letak halaman, Aspose.Words FOSS tidak menghitung pemisahan hyphenasi sendiri – Word menerapkannya saat membuka dan mem-paginasi file.

Konfigurasi Mail Merge

Document.MailMergeSettings adalah instance MailMergeSettings yang 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 FieldMapDatas (OdsoFieldMapDataCollection dari OdsoFieldMapData: Name, MappedName, Column, Type) dan RecipientDatas (OdsoRecipientDataCollection dari OdsoRecipientData: Active, Column, Hash, UniqueTag) menjelaskan pemetaan bidang dan daftar penerima.

Pengaturan Tampilan Dokumen

Document.ViewOptions adalah instance ViewOptions yang mengontrol bagaimana Word menampilkan file saat dibuka: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, dan FormsDesign. Properti ini hanya memengaruhi tampilan Word atas dokumen — tidak berpengaruh pada bagaimana Aspose.Words FOSS memprosesnya.

Proteksi Penulisan

Document.WriteProtection adalah instance WriteProtection (IsWriteProtected, ReadOnlyRecommended) dengan SetPassword() untuk menetapkan kata sandi proteksi dan ValidatePassword() untuk memeriksa kata sandi kandidat terhadapnya.

Satuan Pengukuran

Enum MeasurementUnits menentukan satuan pengukuran yang harus digunakan Word dalam antarmukanya untuk sebuah dokumen.

Tips dan Praktik Terbaik

• CompatibilityOptions.OptimizeFor(MsWordVersion) ada pada kelas tetapi implementasinya belum lengkap dalam build ini – ia melempar NotImplementedException. Atur properti boolean CompatibilityOptions secara individual yang Anda butuhkan secara langsung alih-alih mengandalkan OptimizeFor untuk menerapkan seluruh profil versi sekaligus.
• MailMergeSettings and Odso menyimpan mail-merge configuration yang direkam dalam dokumen – membaca dan menulis konfigurasi tersebut didukung, tetapi mengeksekusi mail merge (mengisi bidang dari sumber data langsung) tidak termasuk dalam edisi sumber terbuka ini.
• HyphenationOptions dan ViewOptions keduanya merupakan preferensi tampilan/UI yang diterapkan oleh Word sendiri – jangan mengharapkan pemanggilan Document.Save() mengubah cara teks membungkus atau tampil berdasarkan pengaturan ini, karena edisi ini tidak menyertakan mesin tata letak halaman.
• Panggil WriteProtection.SetPassword() sebelum mengaktifkan IsWriteProtected, dan gunakan ValidatePassword() untuk memeriksa kata sandi kandidat alih-alih menyimpan atau membandingkan string mentah sendiri.
• CompatibilityOptions, HyphenationOptions, MailMergeSettings, ViewOptions, dan WriteProtection semuanya dapat diakses langsung dari Document – tidak perlu mencari mereka di pohon node.

Masalah Umum

FAQ

Bisakah saya menggunakan Aspose.Words FOSS untuk menjalankan mail merge yang sebenarnya?

Tidak. MailMergeSettings dan Odso memungkinkan Anda membaca dan menulis konfigurasi penggabungan yang disimpan dalam dokumen, tetapi mengeksekusi mail merge – mengisi bidang dari sumber data – tidak termasuk dalam edisi sumber terbuka ini.

Apakah CompatibilityOptions.OptimizeFor() berfungsi?

Tidak – ia melempar NotImplementedException dalam build ini. Atur properti CompatibilityOptions individual yang Anda butuhkan secara langsung sebagai gantinya.

Bagaimana cara melindungi 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 tata letak dokumen?

Tidak. Keduanya adalah preferensi yang disimpan yang diterapkan Microsoft Word saat membuka dan menampilkan file. Edisi ini tidak menyertakan mesin tata letak halaman, jadi pengaturan ini diteruskan tanpa Aspose.Words FOSS itu sendiri menghitung tata letak darinya.

API Reference Ringkasan

Lihat Juga

• Aspose.Words for .NET — Enterprise Documentation