.NET içinde Belge Ayarlarıyla Nasıl Çalışılır
Bu kılavuz, Aspose.Words FOSS for .NET içinde uygulama düzeyinde belge ayarlarıyla nasıl çalışılacağını gösterir: eski uyumluluk anahtarları, tireleme tercihleri, saklanan mail-merge yapılandırması, görünüm seçenekleri ve yazma koruması. Aspose.Words FOSS for .NET, NuGet aracılığıyla veya kaynak koddan derlenerek temin edilebilir.
Adım Adım Kılavuz
Adım 1: Kütüphaneyi Edinin
Depoyu klonlayın ve derleyin Aspose.Words.sln Release yapılandırmasında, ardından bir proje referansı ekleyin Aspose.Words.csproj kendi .NET projenizden, şu şekilde açıklandığı gibi Kurulum kılavuzu. Ekle using Aspose.Words; and using Aspose.Words.Settings; belge ayarlarını okuyan veya yazan herhangi bir dosyanın en üstüne.
Adım 2: Eski Uyumluluk Seçeneklerini Ayarlayın
Document.CompatibilityOptions (bir CompatibilityOptions örneği), belirli eski Word düzeni ve boşluk davranışlarını yeniden üreten onlarca boolean anahtar içerir — örneğin GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage ve SpacingInWholePoints. İhtiyacınız olan bireysel özellikleri doğrudan ayarlayın; OptimizeFor(MsWordVersion) sınıfta mevcut ancak bu derlemede NotImplementedException fırlatıyor, bu yüzden bir bütün versiyon profilini tek seferde uygulayan bir kısayol yok.
Adım 3: Heceleme Tercihlerini Yapılandır
Document.HyphenationOptions (HyphenationOptions bir örnek) belgenin Word heceleme tercihlerini saklar: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps ve HyphenationZone. Bu özellikler isteği kaydedilmiş dosyada yuvarlar; çünkü bu sürümde sayfa-dizayn motoru yoktur, heceleme kesintileri dosyayı Word açıp sayfaladığında hesaplanır, Aspose.Words FOSS tarafından değil.
Adım 4: Posta Birleştirme Yapılandırmasını Oku ve Yaz
Document.MailMergeSettings (MailMergeSettings bir örnek) belgede kaydedilmiş posta-birleştirme yapılandırmasını saklar — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord ve ViewMergedData — ayrıca Clear() ve Clone(). Word’ün Office Data Source Object mekanizmasıyla bağlanan harici bir veri kaynağı için, MailMergeSettings.Odso bir Odso örneği (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) ortaya koyar; bu örneğin FieldMapDatas ve RecipientDatas koleksiyonları alan eşlemesini ve alıcı listesini tanımlar. Bu saklanmış yapılandırmayı okuma ve yazma bu açık-kaynak sürümde mevcuttur; birleştirmenin kendisini canlı bir veri kaynağına karşı çalıştırmak, bu sayfanın kapsamı dışındaki ayrı bir konudur.
Adım 5: Belge Görünüm Ayarlarını Yapılandır
Document.ViewOptions (ViewOptions bir örnek) Word’ün dosyayı açtıktan sonra nasıl görüntülediğini kontrol eder: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries ve FormsDesign. Bu özellikler, yalnızca belgenin Word tarafından gösterilmesini etkileyen saklanmış tercihleri temsil eder — Aspose.Words FOSS’un dosyayı nasıl işlediği üzerinde hiçbir etkisi yoktur.
Adım 6: Yazma Koruması Uygula
Document.WriteProtection (WriteProtection bir örnek) IsWriteProtected ve ReadOnlyRecommended öğelerini ortaya koyar; SetPassword() bir koruma parolası oluşturmak için, ValidatePassword() ise bir aday parolayı buna karşı kontrol etmek için kullanılır. IsWriteProtected = true ayarlamadan önce SetPassword()‘yı çağırın ve ham parola dizesini kendiniz depolamak veya karşılaştırmak yerine ValidatePassword()‘i kullanın.
Yaygın Sorunlar ve Çözümler
CompatibilityOptions.OptimizeFor() throws NotImplementedException. Bu yöntem bu yapıda uygulanmadı. Bireysel CompatibilityOptions ihtiyacınız olan boolean özellikleri doğrudan ayarlayın.
Changing ViewOptions.ZoomPercent oluşturulan çıktıda görünür bir etkisi yoktur. ViewOptions Word tarafından okunan saklanan bir görüntüleme tercihi olup, işleme sırasında Aspose.Words FOSS’un kendisinin uyguladığı bir şey değildir. Düzeltme gerekmez — bu beklenen bir durumdur.
WriteProtection.ValidatePassword() beklenmedik bir şekilde döndürür false. SetPassword() hiç çağrılmadı ya da farklı bir şifre ayarlandı. Çağırın SetPassword() doğrulamadan önce korumalı şifreyi oluşturmak için önce.
Posta birleştirme yapılandırması kaydedilir ancak birleştirme çalışmaz. MailMergeSettings and Odso yalnızca birleştirme yapılandırmasını depolar; bu açık kaynak sürümü birleştirmeyi kendisi yürütmez. Depolanan yapılandırmayı okuyun ve kendi alan doldurma mantığınızı buna göre yönetin.
Sıkça Sorulan Sorular
CompatibilityOptions.OptimizeFor() çalışıyor mu?
Hayır — bu yapıdaki NotImplementedException hatasını verir. Gereken tek tek CompatibilityOptions özelliklerini doğrudan ayarlayın.
Bir belgeyi düzenlemelere karşı şifreyle nasıl korurum?
Document.WriteProtection üzerinde WriteProtection.SetPassword() çağırın, ardından korumayı etkinleştirmek için IsWriteProtected ayarlayın.
Belge Aspose.Words FOSS tarafından işlendiğinde HyphenationOptions ve ViewOptions belgenin görünümünü değiştirir mi?
Hayır. İkisi de Word’ün dosyayı açıp görüntülerken uyguladığı depolanmış tercihleri; bu sürümde bunlar üzerinde doğrudan işlem yapacak bir sayfa-düzeni motoru yok.
Harici bir veri kaynağı için mail-merge veri kaynağı yapılandırmasını nerede bulabilirim?
MailMergeSettings.Odso — FieldMapDatas ve RecipientDatas koleksiyonları sütun eşlemesini ve alıcı dahil etme durumunu tanımlar.
Document.CompatibilityOptions ve Document.ViewOptions arasındaki fark nedir?
CompatibilityOptions anahtarları eski Word düzeni ve boşluk tuhaflıklarını yeniden üretir; ViewOptions ise Word’ün kendi arayüzünün dosyayı nasıl gösterdiğini (yakınlaştırma, biçimlendirme işaretleri) kontrol eder. Hiçbiri Aspose.Words FOSS tarafından hesaplanmaz.
