Belge Ayarlarıyla Çalışma
Belge Ayarlarıyla Çalışma
İçeriğin ötesinde, bir Word belgesi uygulama-düzeyinde ayarlar taşır – eski uyumluluk anahtarları, tireleme tercihleri, saklanan birleştirme yapılandırması, görünüm seçenekleri ve yazma koruması durumu. Aspose.Words FOSS for .NET bunları şunun aracılığıyla ortaya koyar Aspose.Words.Settings ad alanı ve bir avuç özellik üzerinde Document. Bu sayfa her ayar grubunu ve neyi kontrol ettiğini ve neyi kontrol etmediğini kapsar.
Uyumluluk Seçenekleri
Document.CompatibilityOptions, belirli eski Word düzeni ve boşluk davranışlarını yeniden üreten onlarca boolean anahtarı tutan bir CompatibilityOptions örneğidir – örneğin GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout ve BalanceSingleByteDoubleByteWidth. Belgeyi okuyan aşağı akış araçlarda belirli bir Word sürümünün renderleme tuhaflıklarını eşleştirmek için ihtiyaç duyduğunuz özellikleri doğrudan ayarlayın.
Heceleme Tercihleri
Document.HyphenationOptions, belge için Word’ün heceleme tercihlerini depolayan bir HyphenationOptions örneğidir (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone). Bu özellikler isteği çift yönlü olarak taşır; çünkü bu sürüm sayfa düzeni motorunu içermediğinden, Aspose.Words FOSS kendisi heceleme kesimlerini hesaplamaz – Word dosyayı açtığında ve sayfaladığında bunları uygular.
Posta Birleştirme Yapılandırması
Document.MailMergeSettings bir MailMergeSettings örneğidir ve belgedeki MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord ve ViewMergedData kayıtlı posta birleştirme yapılandırmasını, ayrıca Clear() ve Clone()‘i saklar. Word’ün Office Data Source Object mekanizmasıyla bağlanan harici veri kaynakları için, MailMergeSettings.Odso bir Odso örneği (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) ortaya çıkar; bu örneğin FieldMapDatas (OdsoFieldMapDataCollection of OdsoFieldMapData: Name, MappedName, Column, Type) ve RecipientDatas (OdsoRecipientDataCollection of OdsoRecipientData: Active, Column, Hash, UniqueTag) alan eşlemesini ve alıcı listesini tanımlar.
Belge Görünüm Ayarları
Document.ViewOptions bir ViewOptions örneğidir ve Word’ün dosyayı açtığında nasıl gösterdiğini kontrol eder: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries ve FormsDesign. Bu özellikler yalnızca Word’ün belgeyi gösterimini etkiler — Aspose.Words FOSS’un kendisinin belgeyi nasıl işlediği üzerinde hiçbir etkisi yoktur.
Yazma Koruması
Document.WriteProtection bir WriteProtection örneğidir (IsWriteProtected, ReadOnlyRecommended) ve koruma parolası oluşturmak için SetPassword() ve bir aday parolayı kontrol etmek için ValidatePassword() içerir.
Ölçüm Birimleri
MeasurementUnits enumu, Word’ün bir belge için arayüzünde kullanması gereken ölçüm birimini belirler.
İpuçları ve En İyi Uygulamalar
CompatibilityOptions.OptimizeFor(MsWordVersion)sınıfta mevcut ancak bu derlemede uygulanması tamamlanmamış –NotImplementedExceptionistisnası fırlatıyor. Tek tek ihtiyacınız olanCompatibilityOptionsboolean özelliklerini doğrudan ayarlayın,OptimizeForile bir bütün sürüm profili uygulamaya güvenmeyin.MailMergeSettingsandOdsobirleştirme yapılandırmasını sakla configuration belgede kaydedilmiş olan – bu yapılandırmanın okunması ve yazılması desteklenir, ancak birleştirme yürütülmesi (alanların canlı bir veri kaynağından doldurulması) bu açık kaynak sürümünde yer almaz.HyphenationOptionsveViewOptionsWord’ün kendisinin uyguladığı görüntüleme/UI tercihleri olup,Document.Save()‘yi çağırarak metnin nasıl kaydırılacağını veya bu ayarlara göre görünümünü değiştirmesini beklemeyin; çünkü bu sürüm sayfa-düzeni motorunu içermez.WriteProtection.SetPassword()‘ıIsWriteProtected‘i etkinleştirmeden önce çağırın ve ham dizeyi kendiniz depolamak veya karşılaştırmak yerine aday bir şifreyi kontrol etmek içinValidatePassword()‘ı kullanın.CompatibilityOptions,HyphenationOptions,MailMergeSettings,ViewOptionsveWriteProtectiondoğrudanDocument‘ten erişilebilir – bunları düğüm ağacında aramanıza gerek yok.
Yaygın Sorunlar
| Sorun | Neden | Düzelt |
|---|---|---|
CompatibilityOptions.OptimizeFor() NotImplementedException hatasını fırlatır | Bu sürümde uygulanmadı | Bunun yerine ayrı ayrı CompatibilityOptions boolean özelliklerini ayarlayın |
| Posta birleştirme, belgeyi veriyle doldurmaz | MailMergeSettings yalnızca birleştirme yapılandırmasını depolar; yürütme bu sürümde dahil değildir | Depolanan veri kaynağı yapılandırmasını okuyun ve kendi alan doldurma mantığınızı yönetin, ya da ticari sürümü kullanın Aspose.Words için .NET |
ViewOptions.ZoomPercent değiştirmek, belge işlenirken görünür bir etki yaratmaz | ViewOptions sadece Word’ün görüntüsünü etkiler, Aspose.Words FOSS’un kendi işleyişini etkilemez | Beklenen davranış – düzeltme gerekmez |
WriteProtection.ValidatePassword(), beklenmedik şekilde false döndürür | SetPassword() önce çağrılmadı ya da farklı bir şifre ayarlandı | Doğrulamadan önce korumalı şifreyi oluşturmak için SetPassword() çağırın |
FAQ
Gerçek bir mail birleştirmesi çalıştırmak için Aspose.Words FOSS’ı kullanabilir miyim?
Hayır. MailMergeSettings ve Odso, bir belgede depolanan birleştirme yapılandırmasını okumanıza ve yazmanıza izin verir, ancak bir veri kaynağından alanları dolduran posta birleştirmesini yürütmek bu açık kaynak sürümde dahil değildir.
CompatibilityOptions.OptimizeFor() çalışıyor mu?
Hayır – bu derlemede NotImplementedException fırlatıyor. Bunun yerine ihtiyacınız olan bireysel CompatibilityOptions özelliklerini doğrudan ayarlayın.
Bir belgeyi düzenlemelere karşı şifreyle nasıl koruyabilirim?
Document.WriteProtection üzerinde WriteProtection.SetPassword() çağırın, ardından korumayı etkinleştirmek için IsWriteProtected‘yi ayarlayın.
HyphenationOptions ve ViewOptions belgenin düzenlenme şeklini değiştirir mi?
Hayır. İkisi de Microsoft Word’ün dosyayı açıp görüntülerken uyguladığı depolanmış tercihlerdir. Bu sürüm sayfa düzeni motorunu içermediğinden, bu ayarlar Aspose.Words FOSS’un kendisinin onlardan düzen hesaplaması olmadan geçer.
API Reference Özeti
| Sınıf / Enum | Açıklama |
|---|---|
CompatibilityOptions | Eski Word-sürüm düzen/boşluk anahtarları, Document.CompatibilityOptions aracılığıyla |
Compatibility | Bireysel uyumluluk seçeneklerini adlandıran Enum |
MsWordVersion | CompatibilityOptions.OptimizeFor() tarafından kullanılan Word sürüm değerleri |
HyphenationOptions | Tireleme tercihleri, Document.HyphenationOptions aracılığıyla |
MailMergeSettings | Depolanmış posta birleştirme yapılandırması, Document.MailMergeSettings aracılığıyla |
Odso | Posta birleştirme için Office Veri Kaynağı Nesnesi bağlantı ayarları |
OdsoFieldMapData / OdsoFieldMapDataCollection | Bir ODSO veri kaynağı için sütun-birleştirme-alanı eşlemesi |
OdsoRecipientData / OdsoRecipientDataCollection | Posta birleştirme için alıcı başına dahil etme/haric tutma durumu |
ViewOptions | Word görüntüleme tercihleri (yakınlaştırma, biçimlendirme işaretleri), Document.ViewOptions aracılığıyla |
WriteProtection | Belge yazma koruma durumu, Document.WriteProtection aracılığıyla |
MeasurementUnits | Word’ün arayüzünde kullanması gereken ölçü birimi |