Dokumente einfügen und anhängen
Manchmal ist es erforderlich, mehrere Dokumente zu einem zusammenzufassen. Sie können dies manuell tun oder die Aspose.Words-Funktion zum Einfügen oder Anhängen verwenden.
Mit der Einfügeoperation können Sie den Inhalt zuvor erstellter Dokumente in ein neues oder vorhandenes einfügen.
Mit der Anhängefunktion wiederum können Sie ein Dokument nur am Ende eines anderen Dokuments hinzufügen.
In diesem Artikel wird erklärt, wie Sie ein Dokument auf unterschiedliche Weise einfügen oder an ein anderes anhängen können, und es werden die allgemeinen Eigenschaften beschrieben, die Sie beim Einfügen oder Anhängen von Dokumenten anwenden können.
Fügen Sie ein Dokument {#insert-a-document} ein
Wie oben erwähnt, wird ein Dokument in Aspose.Words als Knotenbaum dargestellt, und beim Einfügen eines Dokuments in ein anderes werden Knoten vom ersten Dokumentbaum in den zweiten kopiert.
Sie können Dokumente auf unterschiedliche Weise an verschiedenen Orten einfügen. Beispielsweise können Sie ein Dokument durch einen Ersetzungsvorgang, ein Zusammenführungsfeld während eines Zusammenführungsvorgangs oder über ein Lesezeichen einfügen.
Sie können auch die InsertDocument- oder die InsertDocumentInline-Methode verwenden, die dem Einfügen eines Dokuments in Microsoft Word ähnelt, um ein ganzes Dokument an der aktuellen Cursorposition einzufügen, ohne dass es vorher importiert werden muss.
Das folgende Codebeispiel zeigt, wie man ein Dokument mit der InsertDocument-Methode einfügt:
Das folgende Codebeispiel zeigt, wie man ein Dokument mit der InsertDocumentInline-Methode einfügt:
In den folgenden Unterabschnitten werden die Optionen beschrieben, mit denen Sie ein Dokument in ein anderes einfügen können.
Einfügen eines Dokuments während des Such- und Ersetzungsvorgangs
Sie können Dokumente einfügen, während Sie Such- und Ersetzungsvorgänge ausführen. Beispielsweise kann ein Dokument Absätze mit den Texten [EINFÜHRUNG] und [SCHLUSSFOLGERUNG] enthalten. Im endgültigen Dokument müssen Sie diese Absätze jedoch durch den Inhalt eines anderen externen Dokuments ersetzen. Um dies zu erreichen, müssen Sie einen Handler für das Ersetzungsereignis erstellen.
Das folgende Codebeispiel zeigt, wie Sie einen Handler für das Ersetzungsereignis erstellen, um ihn später im Einfügeprozess zu verwenden:
Das folgende Codebeispiel zeigt, wie der Inhalt eines Dokuments während eines Such- und Ersetzungsvorgangs in ein anderes eingefügt wird:
Ein Dokument während der Mail Merge-Operation {#insert-a-document-during-mail-merge-operation} einfügen
Sie können während eines mail merge-Vorgangs ein Dokument in ein Zusammenführungsfeld einfügen. Eine mail merge-Vorlage kann beispielsweise ein Zusammenführungsfeld wie [Zusammenfassung] enthalten. Im endgültigen Dokument müssen Sie jedoch Inhalte aus einem anderen externen Dokument in dieses Zusammenführungsfeld einfügen. Um dies zu erreichen, müssen Sie einen Handler für das Merge-Ereignis erstellen.
Das folgende Codebeispiel zeigt, wie Sie einen Handler für das Zusammenführungsereignis erstellen, um ihn später im Einfügeprozess zu verwenden:
Das folgende Codebeispiel zeigt, wie Sie mithilfe des erstellten Handlers ein Dokument in das Zusammenführungsfeld einfügen:
Fügen Sie ein Dokument als Lesezeichen {#insert-a-document-at-bookmark} ein
Sie können eine Textdatei in ein Dokument importieren und direkt nach einem Lesezeichen einfügen, das Sie im Dokument definiert haben. Erstellen Sie dazu einen mit einem Lesezeichen versehenen Absatz an der Stelle, an der das Dokument eingefügt werden soll.
Das folgende Codierungsbeispiel zeigt, wie Sie den Inhalt eines Dokuments in ein Lesezeichen in einem anderen Dokument einfügen:
Hängen Sie ein Dokument {#append-a-document} an
Möglicherweise haben Sie einen Anwendungsfall, bei dem Sie zusätzliche Seiten aus einem Dokument am Ende eines vorhandenen Dokuments einfügen müssen. Dazu müssen Sie lediglich die AppendDocument-Methode aufrufen, um ein Dokument am Ende eines anderen hinzuzufügen.
Das folgende Codebeispiel zeigt, wie ein Dokument an das Ende eines anderen Dokuments angehängt wird:
Knoten manuell importieren und einfügen
Mit Aspose.Words können Sie Dokumente automatisch einfügen und anhängen, ohne dass vorherige Importanforderungen erforderlich sind. Wenn Sie jedoch einen bestimmten Knoten Ihres Dokuments einfügen oder anhängen müssen, beispielsweise einen Abschnitt oder einen Absatz, müssen Sie diesen Knoten zunächst manuell importieren.
Wenn Sie einen Abschnitt oder Absatz in einen anderen einfügen oder anhängen müssen, müssen Sie im Wesentlichen die Knoten des ersten Dokumentknotenbaums mithilfe der ImportNode-Methode in den zweiten importieren. Nach dem Import Ihrer Knoten müssen Sie die InsertAfter-/InsertBefore-Methode verwenden, um einen neuen Knoten nach/vor dem Referenzknoten einzufügen. Dadurch können Sie den Einfügevorgang anpassen, indem Sie Knoten aus einem Dokument importieren und an bestimmten Positionen einfügen.
Sie können die AppendChild-Methode auch verwenden, um einen neuen angegebenen Knoten am Ende der Liste der untergeordneten Knoten hinzuzufügen, beispielsweise wenn Sie Inhalte auf Absatzebene statt auf Abschnittsebene anhängen möchten.
Das folgende Codebeispiel zeigt, wie Sie mithilfe der InsertAfter-Methode Knoten manuell importieren und nach einem bestimmten Knoten einfügen:
Der Inhalt wird Abschnitt für Abschnitt in das Zieldokument importiert, was bedeutet, dass Einstellungen wie Seiteneinrichtung und Kopf- oder Fußzeilen beim Import erhalten bleiben. Beachten Sie außerdem, dass Sie beim Einfügen oder Anhängen eines Dokuments Formatierungseinstellungen definieren können, um festzulegen, wie zwei Dokumente zusammengefügt werden.
Allgemeine Eigenschaften für {#common-properties-for-insert-and-append-documents}-Dokumente zum Einfügen und Anhängen
Sowohl die InsertDocument- als auch die AppendDocument-Methode akzeptieren ImportFormatMode und ImportFormatOptions als Eingabeparameter. Mit ImportFormatMode können Sie steuern, wie die Dokumentformatierung zusammengeführt wird, wenn Sie Inhalte aus einem Dokument in ein anderes importieren, indem Sie verschiedene Formatmodi wie UseDestinationStyles, KeepSourceFormatting und KeepDifferentStyles auswählen. Mit der ImportFormatOptions können Sie verschiedene Importoptionen auswählen, z. B. IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists und SmartStyleBehavior.
Mit Aspose.Words können Sie die Visualisierung eines resultierenden Dokuments anpassen, wenn zwei Dokumente in einem Einfüge- oder Anhängevorgang zusammengefügt werden, indem Sie die Section- und PageSetup-Eigenschaften verwenden. Die PageSetup-Eigenschaft enthält alle Attribute eines Abschnitts wie SectionStart, RestartPageNumbering, PageStartingNumber, Orientation und andere. Der häufigste Anwendungsfall besteht darin, die SectionStart-Eigenschaft festzulegen, um zu definieren, ob der hinzugefügte Inhalt auf derselben Seite angezeigt oder in eine neue Seite aufgeteilt wird.
Das folgende Codebeispiel zeigt, wie Sie ein Dokument an ein anderes anhängen und gleichzeitig verhindern, dass sich der Inhalt auf zwei Seiten aufteilt: