插入與追加文件
有時需要將多個文件合併為一個。 您可以手動完成此操作,或使用 Aspose.Words 插入或附加功能。
插入操作讓您將之前創建的文件內容插入新的或現有的文件。
反之,附加功能允許您僅在另一文件的末尾添加一篇文件。
這篇文章解釋了如何以各種方式將文件插入或附加到另一個文件中,並描述了您在插入或附加文件時能應用的常見屬性。
插入一個文件
如上所述,在 Aspose.Words 中,一個文件是作為由節點組成的樹來表示的,將一個文件插入到另一個文件中,就是從第一個文件樹複製節點到第二個文件樹。
你可以用多種不同的方式將文件插入到各個位置。 例如,您可以在替換操作中插入一份文件、在合併操作中使用合併欄位或透過書籤。
您也可以使用類似於在 InsertDocument 中插入文件的 InsertDocumentInline 或 Microsoft Word 方法將整份文件插入到當前光標位置,而無需任何先前的進口。
接下來的程式碼範例示範了透過 InsertDocument 方法插入文件的方法。
以下範例會用 InsertDocumentInline 方法插入檔案:
接下來的小節說明在哪些情況下你可以將一張文件插入另一張文件。
在查找與取代操作中插入文件
您可以在進行尋找與取代操作時插入文件。 例如,一篇文件可以包含一段文字 [ INTRODUCTION ] 和 [ CONCLUSION ]。 但在最終的文件中,你需要用從另一個外部文件獲取的內容來替換這些段落。 要達成這個目標,你必須為 replace 事件建立一個處理器。
接下來的程式碼範例顯示如何建立一個取代事件處理常式,以便在插入程序中使用:
以下範例示意如何在搜尋與替換作業中,將一個文件的内容插入另一個文件中:
在 Mail Merge 操作中插入文件
您可以在 Mail Merge 操作期間將一份文件插入到一個合并欄位中。 例如,一個 Mail Merge 模板可以包含像 [總結] 這樣的合併欄位。 但在最終的文件中,您需要將從另一份外部文件中取得的內容插入此合併欄位。 達到這個目標,您將需要為合併事件建立一個處理器。
以下程式碼範例示範了如何建立併合事件處理常式,以便稍後在插入過程中使用:
以下範例示範了如何透過已建立的處理常式將檔案插入到合併欄位中:
在ブックマーク {#insert-a-document-at-bookmark} にドキュメントを挿入する
您可以將文字檔輸入到文件中,並在您在文件中定義的書籤後面插入它。 為了做到這點,你必須建立一個你希望在哪裡插入該文件的書籤段落。
接下來的程式碼範例示範了如何將一個文件的內容插入到另一個文件的書籤中:
附加文件
你可能有一個用例,需要將一份文件中的其他頁面附加到現有的文件的末尾。 要做到這點,只需調用 AppendDocument 方法將一篇文件加入另一篇文件的末尾即可。
接下來的程式碼範例示範了如何將一個檔案附加到另一個檔案的結尾:
手動匯入和插入節點
Aspose.Words 讓您可以在沒有任何先前的進口要求的情況下,自動插入和附加文件。 不過,如果您需要在您的文件中插入或附加特定的節點,例如一節或一段,那麼您首先需要手動導入此節點。
當你需要插入或附加一段文字或段落到另一個段落時,基本上你需要用 ImportNode 方法將第一份文件節點樹中的節點導入第二個節點樹。 在導入您的節點後,您需要使用 InsertAfter / InsertBefore 方法插入新節點於参考節點後的/前的。 這讓你能夠透過從一個文件中導入節點,並將其插入到特定位置來,自訂插入過程。
您也可以使用 AppendChild 方法將指定節點附加到子節點列表的末尾,例如如果您想要在段落層次上而不是部分層次上附加內容。
接下來的程式碼範例,說明如何透過 InsertAfter 方法,手動匯入節點,並將其插入到特定節點之後:
內容會逐段匯入目的地文件,這意味著在匯入時,頁面設定、標題和页脚等設定會保留。 另外,你可以設定格式化設定,當你插入或附加文書時,指定兩個文書如何連結在一起。
插入和附加文件的共性屬性
InsertDocument 和 AppendDocument 兩種方法都接受 ImportFormatMode 和 ImportFormatOptions 作為輸入參數。 ImportFormatMode允許您透過選取不同的格式模式(如 UseDestinationStyles、KeepSourceFormatting 和 KeepDifferentStyles),控制在從一文件導入另一文件時,如何處理文檔格式的合併。 此 ImportFormatOptions 可以讓您選擇不同的輸入選項,例如 IgnoreHeaderFooter、IgnoreTextBoxes、KeepSourceNumbering、MergePastedLists 和 SmartStyleBehavior。
Aspose.Words 可讓您在將兩份文件合併於插入或附加操作時,使用 Section 和 PageSetup 屬性調整最終文件的顯示。 PageSetup屬性包含某節的各個屬性,如 SectionStart、RestartPageNumbering、PageStartingNumber、Orientation 等。 最常見的用法是將 SectionStart 屬性設定為定義是否會出現在相同頁面或分開到新的一頁。
以下範例顯示如何在不分裂兩頁的情況下將一文档附加到另一文档: