Documenten invoegen en toevoegen

Soms is het nodig om meerdere documenten te combineren in een. U kunt dit handmatig of u kunt gebruiken Aspose.Words functie invoegen of toevoegen.

Met de invoegoperatie kunt u de inhoud van eerder aangemaakte documenten in een nieuwe of bestaande invoegen.

Met de functie toevoegen kunt u een document alleen aan het einde van een ander document toevoegen.

Dit artikel legt uit hoe je een document op verschillende manieren invoegt of toevoegt aan een ander en beschrijft de gemeenschappelijke eigenschappen die je kunt toepassen tijdens het invoegen of toevoegen van documenten.

Document invoegen

Zoals hierboven vermeld, in Aspose.Words een document wordt weergegeven als een boom van knooppunten, en de werking van het invoegen van een document in een ander document is het kopiëren van knooppunten van de eerste documentboom naar de tweede.

U kunt documenten op verschillende locaties op verschillende manieren invoegen. U kunt bijvoorbeeld een document invoegen via een vervangende bewerking, een merge-veld tijdens een merge-operatie of via een bladwijzer.

U kunt ook de insert_document of insert_document_inline methode, die lijkt op het invoegen van een document in Microsoft Word, om een heel document in te voegen op de huidige cursorpositie zonder eerdere import.

Het volgende voorbeeld van code laat zien hoe een document met behulp van de _document invoegen methode:

Het volgende voorbeeld van code laat zien hoe een document met behulp van de invoegen_document_inline methode:

De volgende subsecties beschrijven de opties waarin u het ene document in een ander kunt invoegen.

Een document invoegen bij bladwijzer

U kunt een tekstbestand importeren in een document en het direct invoegen na een bladwijzer die u in het document hebt gedefinieerd. Om dit te doen, maak een paragraaf met bladwijzers waar u wilt dat het document wordt ingevoegd.

Het volgende coderingsvoorbeeld laat zien hoe je de inhoud van het ene document in een bladwijzer in een ander document invoegt:

Merk op dat de bladwijzer niet meerdere alinea’s of tekst moet omsluiten die u wilt dat ze verschijnen in uw uiteindelijke resulterende document.

Een document toevoegen

U kunt een use case hebben waarin u extra pagina’s moet opnemen van een document tot het einde van een bestaand document. Om dit te doen, moet je gewoon de append_document methode om een document aan het einde van een ander document toe te voegen.

Merk op dat append_child is een nodeniveau methode binnen een document. U kunt bijvoorbeeld een alinea maken, formatteren eigenschappen instellen, en vervolgens toevoegen als een kind aan het lichaam met behulp van de append_child methode.

Het volgende voorbeeld van code laat zien hoe je een document toevoegt aan het einde van een ander document:

Knoppen handmatig importeren en invoegen

Aspose.Words Hiermee kunt u documenten automatisch invoegen en toevoegen zonder eerdere importvereisten. Echter, als u een specifieke node van uw document moet invoegen of toevoegen, zoals een sectie of een paragraaf, dan moet u eerst deze node handmatig importeren.

Wanneer u een sectie of paragraaf moet invoegen of toevoegen aan een andere paragraaf, moet u in wezen de knooppunten van de eerste document node boom importeren in de tweede met behulp van de import_node methode. Na het importeren van uw knooppunten, moet u de insert_after ' insert_before methode om een nieuwe knoop in te voegen na/voor het referentieknooppunt. Hiermee kunt u het invoegproces aanpassen door knooppunten uit een document te importeren en het op bepaalde posities in te voegen.

U kunt ook de append_child methode om een nieuw gespecificeerd knooppunt toe te voegen aan het einde van de lijst van kindknooppunten, bijvoorbeeld als u inhoud wilt toevoegen op paragraafniveau in plaats van op sectieniveau.

Het volgende voorbeeld van code laat zien hoe u handmatig knooppunten importeren en invoegen na een specifieke knooppunt met behulp van de insert_after methode:

De import maakt een nieuwe node aan die een kopie is van de originele node en geschikt is voor invoeging in het bestemmingsdocument.

Inhoud wordt per sectie in het document van bestemming geïmporteerd, wat betekent dat instellingen, zoals pagina-instellingen en headers of voetteksten, behouden blijven tijdens import. Het is ook handig om op te merken dat u formatteringsinstellingen kunt definiëren wanneer u een document invoegt of toevoegt om aan te geven hoe twee documenten worden samengevoegd.

Gemeenschappelijke eigenschappen voor invoegen en toevoegen van documenten

Beide insert_document en append_document methoden accepteren ImportFormatMode en ImportFormatOptions als inputparameters. De ImportFormatMode kunt u controleren hoe documentopmaak wordt samengevoegd wanneer u inhoud importeren van het ene document in het andere door het selecteren van verschillende indelingsmodi zoals USE_DESTINATION_STYLES, KEEP_SOURCE_FORMATTING, en KEEP_DIFFERENT_STYLES. De ImportFormatOptions stelt u in staat om verschillende opties te selecteren, zoals ignore_header_footer, ignore_text_boxes, keep_source_numbering, merge_pasted_lists, en smart_style_behavior.

Aspose.Words stelt u in staat om de visualisatie van een resulterend document aan te passen wanneer twee documenten samen worden toegevoegd in een invoeg- of voegbewerking door gebruik te maken van de Section en PageSetup. De page_setup eigenschap bevat alle eigenschappen van een sectie zoals section_start restart_page_numbering, page_starting_number, orientation, en anderen. De meest voorkomende use case is het instellen van de section_start eigenschap om te bepalen of de toegevoegde inhoud op dezelfde pagina zal verschijnen of in een nieuwe zal splitsen.

Merk op dat de Section en PageSetup niet bepalen hoe twee documenten samen worden ingevoegd/toegevoegd. Ze laten je alleen toe om het uiterlijk van je resultaatdocument te veranderen.

Het volgende voorbeeld van code laat zien hoe het ene document aan het andere kan worden toegevoegd, terwijl de inhoud niet over twee pagina’s kan worden gesplitst: