Belge Ekleme ve Ekleme
Bazen birkaç belgeyi bir araya getirmek gerekir. Bunu manuel olarak yapabilir veya Aspose.Words ekle veya ekle özelliğini kullanabilirsiniz.
Ekleme işlemi, önceden oluşturulmuş belgelerin içeriğini yeni veya mevcut bir belgeye eklemenize olanak tanır.
Buna karşılık, ekle özelliği, yalnızca başka bir belgenin sonuna bir belge eklemenize olanak tanır.
Bu makalede, bir belgenin diğerine farklı şekillerde nasıl ekleneceği veya ekleneceği açıklanır ve belge eklerken veya eklerken uygulayabileceğiniz ortak özellikler açıklanır.
Belge Ekleme
Yukarıda bahsedildiği gibi, Aspose.Words ‘da bir belge bir düğüm ağacı olarak temsil edilir ve bir belgeyi diğerine ekleme işlemi, düğümleri ilk belge ağacından ikincisine kopyalamaktır.
Belgeleri farklı konumlara farklı şekillerde ekleyebilirsiniz. Örneğin, bir belgeyi değiştirme işlemi, birleştirme işlemi sırasında birleştirme alanı veya yer imi aracılığıyla ekleyebilirsiniz.
Belgenin tamamını önceki içe aktarmaya gerek kalmadan geçerli imleç konumuna eklemek için Microsoft Word’e belge eklemeye benzer InsertDocument yöntemini de kullanabilirsiniz.
Aşağıdaki kod örneği, InsertDocument yöntemini kullanarak bir 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 [INTRODUCTION] ve [CONCLUSION] metnine sahip paragraflar içerebilir. Ancak son belgede, bu paragrafları başka bir harici belgeden elde edilen içerikle değiştirmeniz gerekir. Bunu başarmak için replace olayı için bir işleyici oluşturmanız gerekir.
Aşağıdaki kod örneği, ekleme işleminde daha sonra kullanmak üzere replacement olayı 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ğini diğerine nasıl ekleyeceğinizi gösterir:
Mail Merge İşlemi Sırasında Bir 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 gerekir.
Aşağıdaki kod örneği, birleştirme olayını ekleme işleminde daha sonra kullanmak üzere 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 bir belgenin nasıl ekleneceğini gösterir:
Yer imine Belge Ekleme
Bir metin dosyasını belgeye içe aktarabilir ve belgede tanımladığınız bir yer iminden hemen sonra ekleyebilirsiniz. Bunu yapmak için, belgenin eklenmesini istediğiniz 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:
Belge Ekleme
Bir belgeden varolan bir belgenin sonuna kadar ek sayfalar eklemeniz gereken bir kullanım durumunuz olabilir. Bunu yapmak için, başka bir belgenin sonuna bir belge eklemek için AppendDocument yöntemini çağırmanız yeterlidir.
Aşağıdaki kod örneği, bir belgenin başka bir belgenin sonuna nasıl ekleneceğini gösterir:
Düğümleri Manuel Olarak İçe Aktarın ve Ekleyin
Aspose.Words, daha önce herhangi bir içe aktarma gereksinimi olmadan belgeleri otomatik olarak eklemenizi ve eklemenizi sağlar. 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, esas olarak ImportNode yöntemini kullanarak ilk belge düğüm ağacının düğümlerini ikincisine içe aktarmanız gerekir. Düğümlerinizi içe aktardıktan sonra, referans düğümden sonra / önce yeni bir düğüm eklemek için InsertAfter /InsertBefore yöntemini kullanmanız gerekir. Bu, bir belgeden düğümleri içe aktararak ve belirli konumlara ekleyerek ekleme işlemini özelleştirmenize olanak tanır.
Alt düğümler listesinin sonuna yeni bir belirtilen düğüm eklemek için AppendChild yöntemini de kullanabilirsiniz, örneğin, bölüm düzeyinde değil paragraf düzeyinde içerik eklemek istiyorsanız.
Aşağıdaki kod örneği, düğümlerin el ile nasıl içe aktarılacağını ve InsertAfter yöntemini kullanarak belirli bir düğümden sonra nasıl ekleneceğini gösterir:
İçerik, bölüm bölüm hedef belgeye içe aktarılır; bu, içe aktarma sırasında sayfa yapısı ve üstbilgi veya altbilgi gibi ayarların korunduğu anlamına gelir. İki belgenin nasıl birleştirileceğini belirtmek için bir belge eklediğinizde veya eklediğinizde biçimlendirme ayarlarını tanımlayabileceğinizi de belirtmekte fayda vardır.
Belge Ekleme ve Ekleme için Ortak Özellikler
Her ikisi de InsertDocument ve AppendDocument yöntemler giriş parametreleri olarak ImportFormatMode ve ImportFormatOptions ‘yi kabul eder. ImportFormatMode, UseDestinationStyles, KeepSourceFormatting ve KeepDifferentStyles gibi farklı biçim modları seçerek bir belgeden diğerine içerik aktardığınızda belge biçimlendirmesinin nasıl birleştirileceğini denetlemenizi sağlar. ImportFormatOptions, aşağıdakiler gibi farklı içe aktarma seçeneklerini seçmenize olanak tanır IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists, ve SmartStyleBehavior.
Aspose.Words, Section ve PageSetup özelliklerini kullanarak bir ekleme veya ekleme işleminde iki belge bir araya getirildiğinde ortaya çıkan belgenin görselleştirilmesini ayarlamanıza olanak tanır. PageSetup özelliği, aşağıdaki gibi bir bölümün tüm niteliklerini içerir SectionStart, RestartPageNumbering, PageStartingNumber, Orientation, ve diğerleri. En yaygın kullanım durumu, eklenen içeriğin aynı sayfada görünüp görünmeyeceğini veya yenisine bölünüp bölünmeyeceğini tanımlamak için SectionStart özelliğini ayarlamaktır.
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: