插入欄位
「插入字段到文件的方式有幾種不同的方法:」
「*使用 DocumentBuilder」
「在本文,我們將更詳細地看每種方式並分析如何透過這些選項插入特定欄位。」
透過 DocumentBuilder 在文件中插入欄位
「在 Aspose.Words 中,InsertField 方法被用來插入新的欄位到文件中。」 「第一個參數接受要插入的欄位完整的欄位程式碼。」 「第二個參數是可選的,可讓您手動設定該欄位結果。」 如果沒有提供這個值,該欄位會自動更新。 「您可以將 null 或空值傳給此參數,來插入包含空欄位值的欄位。」 如果對特定場碼語法不確定,先在 Microsoft Word 中建立該欄位再切換來查看其場碼。
接下來的程式碼範例說明如何透過 DocumentBuilder 在文件中插入合併欄位。
「相同的技術也用於在其他字段內嵌套的欄位。
「以下範例示範了如何透過 DocumentBuilder 來插入嵌套在另一個欄位內的欄位。」
在欄位層級指定當地設定
語言識別符是標準國際數字縮寫,用於某個國家或地理區域的語言。 「使用 Aspose.Words,您可以在欄位層級指定 Lokale 的 LocaleId 屬性,以取得或設定欄位的 Lokale ID。」
「以下範例顯示如何使用此選項:」
「插入未類型化/空字段」
「若你想像 Microsoft Word 一樣插入沒標記/空的欄位 ({}),你可以使用 InsertField 方法並給它 FieldType.FieldNone 參數。」 要在 Word 文檔中插入欄位,你可以按「Ctrl + F9」鍵組合。
接下來的程式碼範例示範了如何在文件中插入一個空欄位:
「使用 FieldBuilder 在文件中插入欄位」
在 Aspose.Words 中插入字段的替代方法是 FieldBuilder 类。 「它提供流暢的介面,讓使用者可以指定欄位開關和引數值,作為文字、節點或甚至是嵌套欄位。」
以下範例顯示如何透過 FieldBuilder 在文件中插入欄位。
透過 DOM 插入欄位
您也可以透過 Aspose.Words Document Object Model (DOM) 插入各種不同類型的欄位。 「在這段中,我們將看看幾個例子。」
透過 DOM 將 Merge Field 插入文件中。
「Word 文檔中的 MERGEFIELD
欄位可以用 FieldMergeField 類別來表示。」 您可以用 FieldMergeField 類別來執行以下動作:
「- 指定合并欄位的名稱」
- 指定合併欄位之格式 “- 指定合併欄位中,從欄位分隔符到欄位結尾之間的文字” “- 指定在字段不為空時要插入的文本” “- 如果該欄位不空,請指定在合併欄位之前插入的文字”
「接下來的程式碼範例說明如何使用『 MERGE
』欄位與『 DOM 』標記來在文件中的段落中加入欄位:」
「將 Mail Merge 欄位插入至 ADDRESSBLOCK
文檔中,使用 DOM」
「ADDRESSBLOCK
」這個欄位可用於在 Word 文檔中插入「mail merge」地址塊。「Word 文檔中的 ADDRESSBLOCK
」欄位可由 FieldAddressBlock 類別表示。 「你可以使用 FieldAddressBlock 類別來執行以下動作:」
“- 指定是否要在欄位中包含該國/地區的名稱”
- 指定是否將地址格式化為收件人的國家/地區所定義的POST*CODE (萬國郵政聯盟2006年) “-指定被排除的國家/地區名稱” 「-指定名稱與地址格式」 “- 指定用於格式化地址的語言ID”
接下來的程式碼示例說明如何使用 DOM 在文件中的段落中新增 Mail Merge 欄位: ADDRESSBLOCK
。
「在沒有使用DocumentBuilder的情況下,將ADVANCE
欄位插入到一個文件中。」
第 ADVANCE
欄用於將線內的後續文字往左、右、上或下偏移。 「Word 文檔中的 ADVANCE
欄位可以由 FieldAdvance 類別來代表。」 「您可以利用 FieldAdvance 類別來執行以下動作:」
「- 指定在欄位後面的文字從頁面頂端移動的點數」
- 指定在欄位後面的文字從欄位、框架或文字方塊的左邊移動多少點數水平位置 “- 指定文字在欄位後的左、右、上或下的移動點數”
接下來的程式碼範例示範了如何將 ADVANCE
欄位透過 DOM 加入到文件中的段落:
「在不使用DocumentBuilder的情況下,將 ASK
欄位插入到文件中」
「ASK
」這個欄位是用來提示使用者在 Word 文檔中輸入要分配給「書籤」的文字。Word 文檔中的「ASK
」欄位可以用「FieldAsk」類別來表示。 「您可以使用 FieldAsk 類別來執行以下動作:」
「- 指定書籤的名稱」
- 指定預設用戶回應 (在提示視窗中包含的初始值) “- 指定用戶回應是否應該在每個 mail merge 操作中接收一次” 「- 指定提示文字(即提示視窗的標題)」
以下範例程式碼示範如何在文件中透過 DOM 來將 ASK
欄位加入段落中:
「將 AUTHOR
欄位插入到一個文档中,而不使用 DocumentBuilder」
「 AUTHOR
」字段用于从 ‘Document
’ 属性中指定文档的作者。 「Word 文件中的 AUTHOR
欄位可以由 FieldAuthor 類別表示。」 「你可以使用 FieldAuthor 類別來執行以下操作:」
- 指定文件作者名稱
接下來是一個示例程式碼,說明如何將 AUTHOR
欄位加入 DOM 到文件中的段落:
「在不使用DocumentBuilder的情況下,將INCLUDETEXT
欄位插入到一個Document中」
「INCLUDETEXT
」字段插入该字段代码中指定的文件中包含的文本和图形。 您可以插入整個文件或由書籤所指向的文件中的一部分。 「Word 文檔中的此欄位由 INCLUDETEXT 表示。」 「您可以使用 FieldIncludeText 類別來執行以下操作:」
“- 指定內含文件的書籤名稱” “- 指定文件的位置”
「接下來的程式碼範例展示了如何在文件中透過 DOM 將 INCLUDETEXT
欄位加入段落中。」
「在沒有使用 DocumentBuilder 的情況下,將 TOA
欄位插入到一個文件中。」
The TOA
(Table of Authorities) 欄位會自動建立並插入目錄表。 「TOA
」欄位會收集由「TA
(資料表引用欄位)」欄位標記的項目。「Microsoft」Excel 會插入「TOA
」欄位,方法是按下「標題目錄」組中的「插入資料表引用」按鈕,「References」標籤。 在您的文件中查看" TOA
“欄位時,語法看起來像這樣:
{ TOA
[Switches ] }
接下來的程式碼範例示範了如何使用 TOA
欄位與 DOM 在文件中的段落中新增欄位。