Alanlara Genel Bakış

Aspose.Words, Microsoft Word belgelerinin sunucu tarafında işlenmesi için tasarlanmış bir sınıf kitaplığıdır ve alanları aşağıdaki şekillerde destekler:

  • bir belgedeki tüm alanlar açma/kaydetme ve dönüştürmeler sırasında korunur
  • çoğu alanın sonuçlarını güncellemek mümkündür

Bu yazımızda alan yapısı, Aspose.Words’te desteklenen alanlar ve bu alanlarla çalışmanın detayları hakkında daha fazla bilgi edineceğiz.

Saha Yapısı

Bir alan şunlardan oluşur:

  • Alan başlangıcı ve ayırıcı düğümler, alan kodunu oluşturan içeriği (normalde düz metin olarak) kapsamak için kullanılır.
  • Alan ayırıcı ve alan ucu, saha sonucunu kapsar. Bu, metin dizilerinden paragraflara ve tablolara kadar çeşitli içerik türlerinden oluşabilir.
  • Bazı alanlarda ayırıcı bulunmayabilir; bu, içeriğin tamamının alan kodunu oluşturduğu anlamına gelir.
  • Alan kodu, alanın davranışını tanımlar ve alan tanımlayıcısından ve genellikle alan adı ve anahtarlar gibi diğer parametrelerden oluşur.
  • Saha sonucu sahanın en güncel değerlendirmesini içerir. Bu değer alan sonucunda saklanır ve kullanıcıya gösterilir. Bazı alanlarda herhangi bir alan sonucu bulunmayabilir, dolayısıyla belgede hiçbir şey görüntülenmez. Aynı şekilde bazı alanlar henüz güncellenmemiş olabilir, bu nedenle alan sonucu da olmayabilir.

fields-aspose-words

Alan kodunu oluşturan içerik, FieldStart ile FieldSeparator arasında Run düğümleri olarak depolanır. Alan sonucu FieldSeparator ve FieldEnd düğümleri arasında depolanır ve çeşitli içerik türlerinden oluşabilir. Normalde alan sonucu yalnızca Run düğümlerinden oluşan metni içerir, ancak FieldEnd düğümünün tamamen farklı bir paragrafta konumlandırılması ve dolayısıyla alan sonucunun Table ve Paragraph düğümleri gibi Bir Belgedeki Düğümlerin Mantıksal Düzeyleri‘den oluşması da mümkündür.

Burada, Github‘de bulunabilen “DocumentExplorer” örneğini kullanarak bir alanın Aspose.Words’te nasıl saklandığına dair bir görünüm bulunmaktadır.

document-explorer-aspose-words

Aspose.Words Document Object Model’deki (DOM) alanlar

Bir belge Aspose.Words’e yüklendiğinde, belgenin alanları bir dizi ayrı bileşen (düğüm) olarak Aspose.Words Document Object Model (DOM)‘ye yüklenir. Tek bir alan, FieldStart, FieldSeparator ve FieldEnd düğümlerinin bir koleksiyonu olarak ve bu düğümler arasındaki içerikle birlikte yüklenir. Bir alanın alan sonucu yoksa FieldSeparator düğümü olmayacaktır. Bu düğümlerin tümü her zaman satır içi olarak bulunur (Paragraph veya SmartTag‘nin çocukları olarak).

Aspose.Words’te FieldXXX düğümlerinin her biri FieldChar‘den türetilir. Bu sınıf, belirtilen düğüm tarafından temsil edilen alan türünü FieldType özelliği aracılığıyla kontrol etmek için bir özellik sağlar. Örneğin FieldType.FieldMergeField, belgedeki bir birleştirme alanını temsil eder.

Desteklenen Alanlar

Aşağıdaki alanların hesaplanması Aspose.Words’in güncel sürümünde desteklenmektedir:

  • = (formül)
  • ADDRESSBLOCK
  • ASK
  • AUTHOR
  • AUTONUM
  • AUTONUMLGL
  • AUTONUMOUT
  • AUTOTEXT
  • BARCODE
  • COMMENTS
  • COMPARE
  • CREATEDATE
  • DATABASE
  • DATE
  • DISPLAYBARCODE
  • DOCPROPERTY
  • DOCVARIABLE
  • EDITTIME
  • EQ
  • FILENAME
  • FILESIZE
  • FILLIN
  • FORMCHECKBOX
  • FORMDROPDOWN
  • FORMTEXT
  • GLOSSARY
  • GOTOBUTTON
  • GREETINGLINE
  • HYPERLINK
  • IF
  • IMPORT
  • INCLUDE
  • INCLUDEPICTURE
  • INCLUDETEXT
  • INDEX
  • INFO
  • KEYWORDS
  • LASTSAVEDBY
  • LISTNUM
  • MACROBUTTON
  • MERGEBARCODE
  • MERGEFIELD
  • MERGEREC
  • MERGESEQ
  • NEXT
  • NEXTIF
  • NOTEREF
  • NUMCHARS
  • NUMPAGES
  • NUMWORDS
  • PAGE
  • PAGEREF
  • PRINTDATE
  • QUOTE
  • REF
  • REVNUM
  • SAVEDATE
  • SECTION
  • SECTIONPAGES
  • SEQ
  • SET
  • SHAPE
  • SKIPIF
  • STYLEREF
  • SUBJECT
  • SYMBOL
  • TEMPLATE
  • TIME
  • TITLE
  • TOA
  • TOC
  • USERADDRESS
  • USERINITIALS
  • USERNAME

Gelişmiş Alan Ayrıştırma

Aspose.Words, Microsoft Word’nin alanları işleme biçimini takip eder ve sonuç olarak şunları doğru şekilde işler:

  • iç içe geçmiş alanlar: IF { =OR({ COMPARE { =2.5 +PRODUCT(3,5 ,8.4) } > 4}, { =2/2 }) } = 1 "Credit not acceptable" "Credit acceptable"
  • alan argümanı iç içe geçmiş bir alanın sonucu olabilir
  • alanlar, alan sonucunun yanı sıra alan kodunun içine de yerleştirilebilir
  • boşluk/boşluk yok, tırnak işaretleri/tırnak işaretleri yok, alanlardaki kaçış karakterleri vb.: MERGEFIELD \f"Text after""Field \n\ame with \" and \\\ and \\\*"\bTextBefor\e
  • birden fazla paragrafa yayılan alanlar

Formül Alanları

Aspose.Words, formül motorunun çok ciddi bir uygulamasını sağlar ve aşağıdakileri destekler:

  • aritmetik ve mantıksal operatörler: =(54+4*(6-77)-(5))+(-6-5)/4/5
  • işlevler: =ABS(-01.4)+2.645/(5.6^3.5)+776457 \\\# "#,##0"
  • yer imlerine referanslar: =IF(C>4, 5,ABS(A)*.76) +3.85
  • sayı biçimlendirme anahtarları: =00000000 \\\# "$#,##0.00;($#,##0.00)"

İfadelerde şu işlevler desteklenir: ABS, AND, AVERAGE, COUNT, DEFINED, FALSE, IF, INT, MAX, MIN, MOD, NOT, OR, PRODUCT, ROUND, SIGN, SUM, TRUE.

IF ve COMPARE Alanları

Aspose.Words’nin kolayca hesaplayabildiği IF ifadelerinden sadece birkaçı size bu özelliğin ne kadar güçlü olduğu hakkında bir fikir vermelidir:

  • IF 3 > 5.7^4+MAX(4,3) True False
  • IF "abcd" > "abc" True False
  • IF "?ab*" = "1abdsg" True False
  • IF 4 = "2*2" True False
  • COMPARE 3+5/34 < 4.6/3/2

DATE ve TIME Alanları

Aspose.Words, Microsoft Word’de bulunan tüm tarih ve saat biçimlendirme anahtarlarını destekler; bazı örnekler şunlardır:

  • DATE @ "d-MMM-yy"
  • DATE @ "d/MM/yyyy h:mm am/pm

Mail Merge Alanları

Aspose.Words, belgelerinizdeki mail merge alanlarının karmaşıklığına herhangi bir sınırlama getirmez ve iç içe IF ve formül alanlarını destekler ve hatta bir formül kullanarak birleştirme alanının adını hesaplayabilir.

Aspose.Words’nin desteklediği mail merge alanlarına bazı örnekler:

  • Mail merge alan anahtarları: MERGEFIELD FirstName \\\\\\\\* FirstCap \b "Mr. "
  • formüldeki iç içe geçmiş birleştirme alanları: IF { MERGEFIELDValue1 } >= {MERGEFIELD Value2 } True False
  • çalışma zamanında birleştirme alanının adını hesaplayın: MERGEFIELD { IF{MERGEFIELDValue1 } >= {MERGEFIELD Value2 } FirstName"LastName" }
  • veri kaynağındaki bir sonraki kayda koşullu geçiş: NEXTIF { MERGEFIELDValue1 } <= { =IF(-2.45 >= 6*{MERGEFIELD Value2 }, 2, -.45) }

Format Anahtarları

Belgedeki bir alan, elde edilen değerin nasıl biçimlendirilmesi gerektiğini belirten biçimlendirme anahtarlarına sahip olabilir. Aspose.Words aşağıdaki format anahtarlarını destekler:

  • \@ – tarih ve saat biçimlendirmesi
  • \# – sayı biçimlendirmesi
  • \* Büyük harfler
  • \* İlk Cap
  • \* Daha düşük
  • \* Üst
  • \* CHARFORMAT – sonucu alan kodunun ilk karakterine göre biçimlendir
  • \* MERGEFORMAT – sonucu eski sonucun nasıl biçimlendirildiğine göre biçimlendir

Alanlarda Date ve Sayı Biçimlendirmesi

Aspose.Words bir alan sonucunu hesapladığında, genellikle bir dizeyi bir sayı veya tarih değerine ayrıştırması ve ayrıca onu tekrar bir dizeye biçimlendirmesi gerekir. Aspose.Words, alan güncellemesi sırasında alan değerlerini hesaplarken varsayılan olarak ayrıştırma ve biçimlendirmeyi gerçekleştirmek için geçerli iş parçacığı kültürünü kullanır. ve mail merge. Alan güncellemesi sırasında hangi kültürün kullanıldığı üzerinde daha fazla kontrole olanak tanıyan FieldOptions sınıfı biçiminde sağlanan seçenekler de vardır.

  • varsayılan olarak FieldUpdateCultureSource özelliği, alanları geçerli iş parçacığı kültürünü kullanarak biçimlendiren CurrentThread olarak ayarlanmıştır
  • bu özellik FieldCode olarak ayarlanabilir, böylece alanın alan kodundan ayarlanan dil bunun yerine biçimlendirme için kullanılır

Geçerli Konunun Kültürünü Kullanarak Biçimlendirme

Alan hesaplaması sırasında kullanılan kültürü kontrol etmek için, alan hesaplamasını başlatmadan önce Thread.CurrentThread.CurrentCulture özelliğini istediğiniz bir kültüre ayarlamanız yeterlidir.

Aşağıdaki kod örneği, güncelleme sırasında biçimlendirme alanlarında kullanılan kültürün nasıl değiştirileceğini gösterir:

Alanları biçimlendirmek için mevcut kültürün kullanılması, sistemin alan güncellemesi sırasında belgedeki tüm alanların nasıl biçimlendirileceğini kolay ve tutarlı bir şekilde kontrol etmesine olanak tanır.

Belgedeki Kültürü Kullanarak Biçimlendirme

Öte yandan Microsoft Word, her bir alanı, alanda bulunan metnin diline (özellikle alan kodundaki çalıştırmalara) göre biçimlendirir. Bazen alan güncellemesi sırasında bu istenen davranış olabilir; örneğin, birçok farklı dilden oluşan içerik içeren küreselleştirilmiş belgeleriniz varsa ve her alanın metinde kullanılan yerel ayarı dikkate almasını istiyorsanız. Aspose.Words de bu işlevselliği destekler.

Document sınıfı, alanların belge içinde nasıl güncellendiğini kontrol etmek için kullanılabilecek üyeleri içeren bir FieldOptions özelliği sağlar.

Aşağıdaki kod örneği, alan güncellemesi sırasında tarih biçimlendirmesi için kullanılan kültürün ve mail merge’in nereden seçileceğinin nasıl belirtileceğini gösterir:

C#'e Alan Ekle