Alanları Ekle

Bir belgeye alan eklemenin birkaç farklı yolu vardır:

• DocumentBuilder kullanarak
• FieldBuilder kullanarak
• kullanım Aspose.Words Belge Nesne Modeli (DOM)

Bu yazıda, her bir yolu daha ayrıntılı olarak ele alacağız ve bu seçenekleri kullanarak belirli alanların nasıl ekleneceğini analiz edeceğiz.

DocumentBuilder kullanarak Bir Belgeye Alan Ekleme

Aspose.Words ‘de InsertField yöntemi bir belgeye yeni alanlar eklemek için kullanılır. İlk parametre, eklenecek alanın tam alan kodunu kabul eder. İkinci parametre isteğe bağlıdır ve alanın alan sonucunun manuel olarak ayarlanmasına izin verir. Bu sağlanmazsa, alan otomatik olarak güncellenir. Boş alan değerine sahip bir alan eklemek için bu parametreye null veya empty iletebilirsiniz. Belirli alan kodu sözdiziminden emin değilseniz, önce Microsoft Word içinde alanı oluşturun ve alan kodunu görmeye geçin.

Alan kodunuzda boşluk içeren bir parametre varsa, bu parametre konuşma işaretlerinin içine alınmalıdır. Aksi takdirde, hem Microsoft Word hem de Aspose.Words içindeki alan beklendiği gibi çalışmayabilir, çünkü parametre her ikisi tarafından da kesilmiş olarak kabul edilir

Aşağıdaki kod örneği, DocumentBuilder kullanarak bir belgeye birleştirme alanının nasıl ekleneceğini gösterir.:

Aynı teknik, diğer alanlara iç içe geçmiş alanlar eklemek için kullanılır.

Aşağıdaki kod örneği, DocumentBuilder kullanarak başka bir alana iç içe geçmiş alanların nasıl ekleneceğini gösterir:

Alan Düzeyinde Yerel Ayarı Belirtin

Dil tanımlayıcısı, bir ülkedeki veya coğrafi bölgedeki dilin standart uluslararası sayısal kısaltmasıdır. Aspose.Words ile, alanın yerel ayarını ID alan veya ayarlayan LocaleId özelliğini kullanarak alan düzeyinde Yerel Ayarı belirtebilirsiniz.

Aşağıdaki kod örneği, bu seçeneğin nasıl kullanılacağını gösterir:

Yazılmamış / Boş Alan Ekle

Microsoft Word’nin izin verdiği gibi türlenmemiş / boş alanlar ({}) eklemek istiyorsanız, FieldType.FieldNone parametresiyle InsertField yöntemini kullanabilirsiniz. Bir Word belgesine alan eklemek için “Ctrl + F9” tuş bileşimine basabilirsiniz.

Aşağıdaki kod örneği, belgeye boş bir alanın nasıl ekleneceğini gösterir:

FieldBuilder kullanarak Bir Belgeye Alan Ekleme

Aspose.Words ‘e alan eklemenin alternatif yolu FieldBuilder sınıfıdır. Alan anahtarlarını ve bağımsız değişken değerlerini metin, düğümler ve hatta iç içe geçmiş alanlar olarak belirtmek için akıcı bir arayüz sağlar.

Aşağıdaki kod örneği, FieldBuilder kullanarak bir belgeye nasıl alan ekleneceğini gösterir:

DOM kullanarak Alan ekleme

Kullanarak çeşitli alan türleri de ekleyebilirsiniz Aspose.Words Belge Nesne Modeli (DOM). Bu bölümde birkaç örneğe bakacağız.

DOM kullanarak Belgeye Birleştirme Alanı Ekleme

Word belgesindeki MERGEFIELD alanı FieldMergeField sınıfı ile gösterilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldMergeField sınıfını kullanabilirsiniz:

• birleştirme alanının adını belirtin
• birleştirme alanının biçimlendirmesini belirtin
• alan ayırıcısı ile birleştirme alanının alan sonu arasındaki metni belirtin
• alan boş değilse, birleştirme alanından sonra eklenecek metni belirtin
• alan boş değilse, birleştirme alanından önce eklenecek metni belirtin

Daha fazla ayrıntı için bkz. FieldMergeField sınıfı API.

Aşağıdaki kod örneği, belgedeki bir paragrafa DOM kullanarak MERGE alanının nasıl ekleneceğini gösterir:

Bu örneğin örnek dosyasını şu adresten indirebilirsiniz Aspose.Words GitHub.

DOM kullanarak bir Belgeye Mail Merge Adres Bloğu alanı ekleme

ADDRESSBLOCK alanı, bir Word belgesine Mail Merge adres bloğu eklemek için kullanılır. Word belgesindeki ADDRESSBLOCK alanı FieldAddressBlock sınıfı ile gösterilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAddressBlock sınıfını kullanabilirsiniz:

• alana ülke/bölge adının eklenip eklenmeyeceğini belirtin
• adresin alıcının ülkesine/bölgesine göre POST*CODE ile tanımlandığı şekilde biçimlendirilip biçimlendirilmeyeceğini belirtin (Evrensel Posta Birliği 2006)
• hariç tutulan ülke/bölge adını belirtin
• ad ve adres biçimini belirtin
• adresi biçimlendirmek için kullanılan ID dilini belirtin

Daha fazla ayrıntı için bkz. FieldAddressBlock sınıfı API.

Aşağıdaki kod örneği, belgedeki bir paragrafa DOM kullanarak Mail Merge ADDRESSBLOCK Alanının nasıl ekleneceğini gösterir:

Bu örneğin örnek dosyasını şu adresten indirebilirsiniz Aspose.Words GitHub.

DocumentBuilder kullanmadan bir Belgeye İlerleme alanı ekleme

ADVANCE alanı, bir satır içindeki sonraki metni sola, sağa, yukarı veya aşağı kaydırmak için kullanılır. Word belgesindeki ADVANCE alanı FieldAdvance sınıfı ile gösterilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAdvance sınıfını kullanabilirsiniz:

• alanı izleyen metnin sayfanın üst kenarından dikey olarak taşınması gereken nokta sayısını belirtin
• alanı izleyen metnin sütunun, çerçevenin veya metin kutusunun sol kenarından yatay olarak taşınması gereken nokta sayısını belirtin
• alanı izleyen metnin sola, sağa, yukarı veya aşağı taşınması gereken nokta sayısını belirtin

Daha fazla ayrıntı için bkz. FieldAdvance sınıfı API.

Aşağıdaki kod örneği, belgedeki bir paragrafa DOM kullanarak ADVANCE Alanının nasıl ekleneceğini gösterir:

Bu örneğin örnek dosyasını şu adresten indirebilirsiniz Aspose.Words GitHub.

DocumentBuilder kullanmadan bir Belgeye ASK alanı ekleme

ASK alanı, kullanıcıdan Word belgesindeki bir Yer İmine metin atamasını istemek için kullanılır. Word belgesindeki ASK alanı FieldAsk sınıfı ile gösterilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAsk sınıfını kullanabilirsiniz:

• yer iminin adını belirtin
• varsayılan kullanıcı yanıtını belirtin (bilgi istemi penceresinde bulunan başlangıç değeri)
• Mail Merge işlemi başına kullanıcı yanıtının bir kez alınıp alınmayacağını belirtin
• bilgi istemi metnini belirtin (bilgi istemi penceresinin başlığı)

Daha fazla ayrıntı için bkz. FieldAsk sınıfı API.

Aşağıdaki kod örneği, belgedeki bir paragrafa DOM kullanarak ASK Alanının nasıl ekleneceğini gösterir:

Bu örneğin örnek dosyasını şu adresten indirebilirsiniz Aspose.Words GitHub.

DocumentBuilder kullanmadan bir Belgeye AUTHOR alanı ekleme

AUTHOR alanı, Belgenin yazarının adını Document özelliklerinden belirtmek için kullanılır. Word belgesindeki AUTHOR alanı FieldAuthor sınıfı ile temsil edilebilir. Aşağıdaki işlemleri gerçekleştirmek için FieldAuthor sınıfını kullanabilirsiniz:

• belge yazarının adını belirtin

Daha fazla ayrıntı için bkz. FieldAuthor sınıfı API.

Aşağıdaki kod örneği, belgedeki bir paragrafa DOM kullanarak AUTHOR Alanının nasıl ekleneceğini gösterir:

Bu örneğin örnek dosyasını şu adresten indirebilirsiniz Aspose.Words GitHub.

DocumentBuilder kullanmadan bir Belgeye INCLUDETEXT alanı ekleme

INCLUDETEXT alanı, alan kodunda adı geçen belgede yer alan metin ve grafikleri ekler. Belgenin tamamını veya belgenin yer imiyle başvurulan bir bölümünü ekleyebilirsiniz. Word belgesindeki bu alan INCLUDETEXT ile gösterilir. Aşağıdaki işlemleri gerçekleştirmek için FieldIncludeText sınıfını kullanabilirsiniz:

• yer iminin dahil edilen belgenin adını belirtin
• belgenin konumunu belirtin

Daha fazla ayrıntı için bkz. FieldIncludeText sınıfı API.

Aşağıdaki kod örneği, belgedeki bir paragrafa DOM kullanarak INCLUDETEXT alanının nasıl ekleneceğini gösterir:

DocumentBuilder kullanmadan bir Belgeye TOA alanı ekleme

TOA (Table of Authorities) alanı bir yetki tablosu oluşturur ve ekler. TOA alanı, TA (Table of Authorities Entry) alanlarıyla işaretlenmiş girdileri toplar. Microsoft Office Word, References sekmesindeki Table of Authorities grubunda Insert Table of Authorities‘yi tıklattığınızda TOA alanını ekler. Belgenizdeki TOA alanını görüntülediğinizde, sözdizimi şöyle görünür:

{ TOA [Switches ] }

Daha fazla ayrıntı için bkz. FieldToa sınıfı API.

Aşağıdaki kod örneği, belgedeki bir paragrafa DOM kullanarak TOA alanının nasıl ekleneceğini gösterir:

/