Belge Ekleme ve Ekleme

Bazen birden fazla belgenin tek bir belgede birleştirilmesi gerekebilir. Bunu manuel olarak yapabileceğiniz gibi Aspose.Words ekleme veya ekleme özelliğini de kullanabilirsiniz.

Ekleme işlemi, önceden oluşturulmuş belgelerin içeriğini yeni veya mevcut bir belgeye eklemenizi sağlar.

Buna karşılık, ekleme özelliği bir belgeyi yalnızca başka bir belgenin sonuna eklemenize olanak tanır.

Bu makalede, bir belgenin diğerine farklı yollarla nasıl ekleneceği veya ekleneceği açıklanmakta ve belge eklerken veya eklerken uygulayabileceğiniz ortak özellikler açıklanmaktadır.

Belge {#insert-a-document} Ekle

Yukarıda belirtildiği gibi, Aspose.Words’te bir belge bir düğüm ağacı olarak temsil edilir ve bir belgeyi diğerine ekleme işlemi, düğümlerin birinci belge ağacından ikincisine kopyalanmasıdır.

Belgeleri çeşitli konumlara farklı şekillerde ekleyebilirsiniz. Örneğin, bir belgeyi değiştirme işlemi yoluyla, birleştirme işlemi sırasında birleştirme alanıyla veya yer işaretiyle ekleyebilirsiniz.

Ayrıca, Microsoft Word’e belge eklemeye benzer olan InsertDocument veya InsertDocumentInline yöntemini de, daha önce herhangi bir içe aktarma işlemi yapmadan belgenin tamamını geçerli imleç konumuna eklemek için kullanabilirsiniz.

Aşağıdaki kod örneği, InsertDocument yöntemini kullanarak belgenin nasıl ekleneceğini gösterir:

Aşağıdaki kod örneği, InsertDocumentInline yöntemini kullanarak belgenin nasıl ekleneceğini gösterir:

Aşağıdaki alt bölümlerde bir belgeyi diğerine ekleyebileceğiniz seçenekler açıklanmaktadır.

Bul ve Değiştir İşlemi Sırasında Belge Ekleme

Bul ve değiştir işlemlerini gerçekleştirirken belge ekleyebilirsiniz. Örneğin, bir belge [GİRİŞ] ve [SONUÇ] metnini içeren paragraflar içerebilir. Ancak son belgede bu paragrafları başka bir harici belgeden alınan içerikle değiştirmeniz gerekir. Bunu başarmak için, değiştirme olayı için bir işleyici oluşturmanız gerekecektir.

Aşağıdaki kod örneği, değiştirme olayının daha sonra ekleme işleminde kullanılması için bir işleyicinin nasıl oluşturulacağını gösterir:

Aşağıdaki kod örneği, bul ve değiştir işlemi sırasında bir belgenin içeriğinin diğerine nasıl ekleneceğini gösterir:

Mail Merge İşlemi Sırasında Belge Ekleme

mail merge işlemi sırasında birleştirme alanına belge ekleyebilirsiniz. Örneğin, bir mail merge şablonu [Özet] gibi bir birleştirme alanı içerebilir. Ancak son belgede, başka bir harici belgeden elde edilen içeriği bu birleştirme alanına eklemeniz gerekir. Bunu başarmak için birleştirme olayı için bir işleyici oluşturmanız gerekecektir.

Aşağıdaki kod örneği, birleştirme olayının daha sonra ekleme işleminde kullanması için bir işleyicinin nasıl oluşturulacağını gösterir:

Aşağıdaki kod örneği, oluşturulan işleyiciyi kullanarak birleştirme alanına nasıl belge ekleneceğini gösterir:

{#insert-a-document-at-bookmark} Yer İşaretine Bir Belge Ekleme

Bir metin dosyasını bir belgeye aktarabilir ve belgede tanımladığınız yer işaretinin hemen sonrasına ekleyebilirsiniz. Bunu yapmak için belgenin eklenmesini istediğiniz yere yer imli bir paragraf oluşturun.

Aşağıdaki kodlama örneği, bir belgenin içeriğinin başka bir belgedeki yer imine nasıl ekleneceğini gösterir:

Yer iminin, nihai belgenizde görünmesini istediğiniz birden fazla paragrafı veya metni içermemesi gerektiğini unutmayın.

Bir Belge {#append-a-document} Ekleme

Bir belgeden mevcut bir belgenin sonuna kadar ek sayfalar eklemenizi gerektiren bir kullanım durumunuz olabilir. Bunu yapmak için, bir belgeyi diğerinin sonuna eklemek için AppendDocument yöntemini çağırmanız yeterlidir.

AppendChild‘in bir belge içindeki düğüm düzeyinde bir yöntem olduğunu unutmayın. Örneğin, bir paragraf oluşturabilir, biçimlendirme özelliklerini ayarlayabilir ve ardından AppendChild yöntemini kullanarak onu alt öğe olarak gövdeye ekleyebilirsiniz.

Aşağıdaki kod örneği, bir belgenin başka bir belgenin sonuna nasıl ekleneceğini gösterir:

Düğümleri Manuel Olarak İçe Aktarma ve Ekleme

Aspose.Words, önceden herhangi bir içe aktarma gereksinimi olmadan belgeleri otomatik olarak eklemenize ve eklemenize olanak tanır. Ancak belgenize bölüm veya paragraf gibi belirli bir düğüm eklemeniz veya eklemeniz gerekiyorsa, önce bu düğümü manuel olarak içe aktarmanız gerekir.

Bir bölümü veya paragrafı diğerine eklemeniz veya eklemeniz gerektiğinde, esasen ilk belge düğüm ağacının düğümlerini ImportNode yöntemini kullanarak ikinciye aktarmanız gerekir. Düğümlerinizi içe aktardıktan sonra, referans düğümün arkasına/öncesine yeni bir düğüm eklemek için InsertAfter/InsertBefore yöntemini kullanmanız gerekir. Bu, bir belgeden düğümleri içe aktarıp belirli konumlara ekleyerek ekleme işlemini özelleştirmenize olanak tanır.

Örneğin, içeriği bölüm düzeyi yerine paragraf düzeyinde eklemek istiyorsanız, alt düğümler listesinin sonuna yeni bir belirtilen düğüm eklemek için AppendChild yöntemini de kullanabilirsiniz.

Aşağıdaki kod örneği, düğümlerin manuel olarak nasıl içe aktarılacağını ve bunların InsertAfter yöntemini kullanarak belirli bir düğümden sonra nasıl ekleneceğini gösterir:

İçe aktarma, orijinal düğümün kopyası olan ve hedef belgeye eklenmeye uygun yeni bir düğüm oluşturur.

İçerik, hedef belgeye bölüm bölüm içe aktarılır; bu, sayfa düzeni ve üstbilgiler veya altbilgiler gibi ayarların içe aktarma sırasında korunduğu anlamına gelir. İki belgenin nasıl bir araya getirileceğini belirlemek için bir belge eklediğinizde veya eklerken biçimlendirme ayarlarını tanımlayabileceğinizi de unutmamakta fayda var.

Belge Eklemek ve Eklemek için Ortak Özellikler

Hem InsertDocument hem de AppendDocument yöntemleri, giriş parametreleri olarak ImportFormatMode ve ImportFormatOptions‘i kabul eder. ImportFormatMode, UseDestinationStyles, KeepSourceFormatting ve KeepDifferentStyles gibi farklı format modlarını seçerek bir belgeden diğerine içerik aktardığınızda belge formatının nasıl birleştirileceğini kontrol etmenize olanak tanır. ImportFormatOptions, IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists ve SmartStyleBehavior gibi farklı içe aktarma seçeneklerini seçmenize olanak tanır.

Aspose.Words, Section ve PageSetup özelliklerini kullanarak bir ekleme veya ekleme işleminde iki belge birbirine eklendiğinde ortaya çıkan belgenin görselleştirmesini ayarlamanıza olanak tanır. PageSetup özelliği bir bölümün SectionStart, RestartPageNumbering, PageStartingNumber, Orientation ve diğerleri gibi tüm niteliklerini içerir. En yaygın kullanım durumu, eklenen içeriğin aynı sayfada mı görüneceğini yoksa yeni bir sayfaya mı bölüneceğini tanımlamak için SectionStart özelliğini ayarlamaktır.

Section ve PageSetup özelliklerinin iki belgenin birbirine nasıl eklendiğini/eklendiğini denetlemediğini unutmayın. Yalnızca sonuç belgenizin görünümünü değiştirmenize izin verirler.

Aşağıdaki kod örneği, içeriğin iki sayfaya bölünmesini önlerken bir belgenin diğerine nasıl ekleneceğini gösterir: