Dokumente einfügen und anfügen
Manchmal ist es erforderlich, mehrere Dokumente zu einem zu kombinieren. Sie können dies manuell tun oder Sie können Aspose.Words einfügen oder anhängen Funktion.
Mit der Insert-Operation können Sie den Inhalt der zuvor erstellten Dokumente in eine neue oder bestehende einfügen.
Die Append-Funktion ermöglicht es Ihnen, ein Dokument nur am Ende eines anderen Dokuments hinzuzufügen.
Dieser Artikel erklärt, wie man ein Dokument auf unterschiedliche Weise einfügen oder anhängen kann und beschreibt die gemeinsamen Eigenschaften, die Sie beim Einfügen oder Anfügen von Dokumenten anwenden können.
Dokument einfügen
Wie oben erwähnt, in Aspose.Words ein Dokument als Baum von Knoten dargestellt ist, und der Betrieb des Einfügens eines Dokuments in ein anderes Kopieren von Knoten vom ersten Dokumentbaum zum zweiten.
Sie können Dokumente in einer Vielzahl von Standorten auf verschiedene Weise einfügen. Beispielsweise können Sie ein Dokument durch einen Austauschvorgang, ein Zusammenschlussfeld während eines Zusammenschlussvorgangs oder über ein Lesezeichen einfügen.
Sie können auch die InsertDocument oder InsertDocumentInline Verfahren, das dem Einfügen eines Dokuments ähnlich ist Microsoft Word, ein ganzes Dokument an der aktuellen Cursorposition ohne vorherige Importierung einfügen.
Das folgende Codebeispiel zeigt, wie ein Dokument mit dem InsertDocument Methode:
Das folgende Codebeispiel zeigt, wie ein Dokument mit dem InsertDocumentInline Methode:
Die folgenden Unterabschnitte beschreiben die Optionen, bei denen Sie ein Dokument in ein anderes einfügen können.
Einfügen eines Dokumentes während des Suchens und Ersetzens der Operation
Sie können Dokumente einfügen, während Sie die Operationen finden und ersetzen. Ein Dokument kann beispielsweise Absätze mit dem Text [INTRODUCTION] und [CONCLUSION] enthalten. Aber im endgültigen Dokument müssen Sie diese Absätze durch den Inhalt eines anderen externen Dokuments ersetzen. Um dies zu erreichen, müssen Sie einen Handler für das Ersatzereignis erstellen.
Das folgende Codebeispiel zeigt, wie man einen Handler für das ersetzende Ereignis erstellt, um ihn später im Einsetzen zu verwenden:
Das folgende Codebeispiel zeigt, wie der Inhalt eines Dokuments während eines Funds in ein anderes eingefügt und ersetzt wird:
Ein Dokument einfügen Mail Merge Betrieb
Sie können während einer mail merge Betrieb. Zum Beispiel a mail merge Template kann ein Zusammenschlussfeld wie [Summary] enthalten. Aber im letzten Dokument müssen Sie Inhalte einfügen, die von einem anderen externen Dokument erhalten wurden. Um dies zu erreichen, müssen Sie einen Handler für das Merger-Event erstellen.
Das folgende Codebeispiel zeigt, wie ein Handler für das Fusionsereignis erstellt werden kann, um es später im Insertionsprozess zu verwenden:
Das folgende Codebeispiel zeigt, wie ein Dokument mit dem erstellten Handler in das Zusammenführungsfeld eingefügt werden kann:
Ein Dokument bei Bookmark einfügen
Sie können eine Textdatei in ein Dokument importieren und nach einem im Dokument definierten Lesezeichen einfügen. Um dies zu tun, erstellen Sie einen beschrifteten Absatz, in dem das Dokument eingefügt werden soll.
Das folgende Codierungsbeispiel zeigt, wie man den Inhalt eines Dokuments in ein anderes Dokument einfügen kann:
Dokument anhängen
Sie können einen Anwendungsfall haben, in dem Sie zusätzliche Seiten von einem Dokument bis zum Ende eines vorhandenen Dokuments einfügen müssen. Um dies zu tun, müssen Sie nur die AppendDocument Verfahren zum Hinzufügen eines Dokuments zum Ende eines anderen.
Das folgende Codebeispiel zeigt, wie ein Dokument am Ende eines anderen Dokuments angehängt werden kann:
Nodes manuell importieren und einfügen
Aspose.Words Sie können Dokumente automatisch ohne vorherige Importanforderungen einfügen und anhängen. Wenn Sie jedoch einen bestimmten Knoten Ihres Dokuments, wie einen Abschnitt oder einen Absatz, einfügen oder anhängen müssen, müssen Sie zuerst diesen Knoten manuell importieren.
Wenn Sie einen Abschnitt oder einen Absatz in einen anderen einfügen oder anhängen müssen, müssen Sie im Wesentlichen die Knoten des ersten Dokumentknotenbaums mit dem zweiten einführen. ImportNode Methode. Nach dem Import Ihrer Knoten müssen Sie die InsertAfter Verfahren zum Einfügen eines neuen Knotens nach/vor dem Referenzknoten. Dadurch können Sie den Einlegevorgang anpassen, indem Sie Knoten aus einem Dokument importieren und an gegebenen Positionen einfügen.
Sie können auch die AppendChild Verfahren zum Hinzufügen eines neuen spezifizierten Knotens zum Ende der Liste der Kinderknoten, zum Beispiel, wenn Sie Inhalte auf der Absatzebene anstelle auf der Abschnittsebene anhängen möchten.
Das folgende Codebeispiel zeigt, wie man Knoten manuell importiert und nach einem bestimmten Knoten mit dem InsertAfter Methode:
Der Inhalt wird im Abschnitt des Zieldokuments nach Abschnitt importiert, d.h. während des Imports werden Einstellungen, wie z.B. Page Setup und Header oder Footer, erhalten. Es ist auch nützlich zu beachten, dass Sie Formatierungseinstellungen definieren können, wenn Sie ein Dokument einfügen oder anhängen, um anzugeben, wie zwei Dokumente zusammengefügt werden.
Gemeinsame Eigenschaften für Einfügen und Anwenden von Dokumenten
Beide InsertDocument und AppendDocument Methoden akzeptieren ImportFormatMode und ImportFormatOptions als Eingangsparameter. Die ImportFormatMode Sie können kontrollieren, wie die Dokumentenformatierung zusammengeführt wird, wenn Sie Inhalte aus einem Dokument in ein anderes importieren, indem Sie verschiedene Formatmodi wie UseDestinationStyles, KeepSourceFormatting, und KeepDifferentStyles. Die ImportFormatOptions Sie können verschiedene Importoptionen wie IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists, und SmartStyleBehavior.
Aspose.Words ermöglicht es Ihnen, die Visualisierung eines resultierenden Dokuments anzupassen, wenn zwei Dokumente in einem Einsatz- oder Append-Betrieb zusammengefügt werden, indem die Section und PageSetup Eigenschaften. Die PageSetup Eigenschaft enthält alle Attribute eines Abschnitts wie SectionStart, RestartPageNumbering, PageStartingNumber, Orientation, und andere. Der häufigste Anwendungsfall ist die SectionStart Eigenschaft zu definieren, ob der hinzugefügte Inhalt auf der gleichen Seite angezeigt wird oder in eine neue aufgeteilt wird.
Das folgende Codebeispiel zeigt, wie man ein Dokument an ein anderes anpasst, während der Inhalt von der Aufteilung auf zwei Seiten bleibt: