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 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 aracılığıyla, birleştirme işlemi sırasında birleştirme alanı yoluyla veya yer işareti aracılığıyla ekleyebilirsiniz.
Ayrıca, Microsoft Word’e belge eklemeye benzer olan insert_document veya insert_document_inline 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, insert_document yöntemini kullanarak belgenin nasıl ekleneceğini gösterir:
Aşağıdaki kod örneği, insert_document_inline 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.
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:
Belge Ekle
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 append_document 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 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 import_node 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 insert_after/insert_before 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 append_child yöntemini de kullanabilirsiniz.
Aşağıdaki kod örneği, düğümlerin manuel olarak nasıl içe aktarılacağını ve bunların insert_after yöntemini kullanarak belirli bir düğümden sonra nasıl ekleneceğini gösterir:
İç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 insert_document hem de append_document yöntemleri, giriş parametreleri olarak ImportFormatMode ve ImportFormatOptions‘i kabul eder. ImportFormatMode, USE_DESTINATION_STYLES, KEEP_SOURCE_FORMATTING ve KEEP_DIFFERENT_STYLES 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, ignore_header_footer, ignore_text_boxes, keep_source_numbering, merge_pasted_lists ve smart_style_behavior gibi farklı içe aktarma seçeneklerini seçmenize olanak tanır.
Aspose.Words, Section ve PageSetup kullanılarak bir ekleme veya ekleme işleminde iki belge birbirine eklendiğinde ortaya çıkan belgenin görselleştirmesini ayarlamanıza olanak tanır. page_setup özelliği bir bölümün section_start, restart_page_numbering, page_starting_number, 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 section_start ö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: