Word格式處理控件Aspose.Words for .NET教程——更新和刪除字段

---

Aspose.Words for .NET是一種高級Word文檔處理API，用于執行各種文檔管理和操作任務。API支持生成，修改，轉換，呈現和打印文檔，而無需在跨平臺應用程序中直接使用Microsoft Word。此外，API支持所有流行的Word處理文件格式，并允許將Word文檔導出或轉換為固定布局文件格式和最常用的圖像/多媒體格式。

>>Aspose.Words for .NET已經更新至v20.7，添加了新節點以處理多節結構化文檔標簽，改進了SmartArt冷渲染的性能，RevisionOptions類擴展了新的屬性，點擊下載體驗

---

如何更新字段

加載文檔后，Aspose.Words模仿Microsoft Word的行為，并且自動更新字段選項已關閉。該行為可以總結如下：

• 當您打開/保存文檔時，這些字段保持不變。
• 根據需要顯式更新文檔中的所有字段（例如，重建TOC）。
• 當打印/渲染為PDF或XPS時，頁眉/頁腳中與頁碼相關的字段將更新。
• 執行郵件合并時，所有字段都會自動更新。

以編程方式更新字段

要顯式更新整個文檔中的字段，只需調用Document.UpdateFields。要更新文檔一部分中包含的字段，請獲取Range對象并調用Range.UpdateFields方法。在Aspose.Words中，可以使用Node.Range屬性為文檔樹中的任何節點（例如Section，HeaderFooter，Paragraph等）獲取Range。可以通過調用Field.Update來更新單個字段的結果。

渲染期間頁面相關字段的自動更新

當執行將文檔轉換為固定頁面格式（例如PDF或XPS）時，Aspose.Words會自動更新與頁面布局相關的字段PAGE，PAGEREF，這些字段位于文檔的頁眉/頁腳中。此行為模仿了打印文檔時Microsoft Word的行為。如果要更新文檔中的所有其他字段，則需要在呈現文檔之前調用Document.UpdateFields。

// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_WorkingWithFields();

Document doc = new Document(dataDir + "Rendering.doc");

// This updates all fields in the document.
doc.UpdateFields();
dataDir = dataDir + "Rendering.UpdateFields_out.pdf";
doc.Save(dataDir);

郵件合并期間的自動字段更新

當執行郵件合并時，文檔中的所有字段都會自動更新。這是因為郵件合并是字段更新的情況。該程序遇到一個郵件合并字段，需要更新其結果，這涉及從數據源獲取值并將其插入該字段中。邏輯當然更復雜，例如，當到達文檔/郵件合并區域的末尾但仍然有其他數據要合并時，則需要復制該區域并更新新的字段集。

更新具有dirty屬性的字段

w：dirty是一個字段級屬性，將僅在您打開文檔時刷新您指定的字段。它告訴MS Word僅在下次打開文檔時刷新此字段。使用LoadOptions.UpdateDirtyFields屬性來指定是否使用dirty屬性更新字段。當LoadOptions.UpdateDirtyFields的值設置為true時，將在文檔加載時更新Field.IsDirty或FieldChar.IsDirty屬性具有真值的所有字段。以下示例顯示如何更新具有臟屬性的字段。

LoadOptions lo = new LoadOptions();

//Update the fields with the dirty attribute
lo.UpdateDirtyFields = true;

//Load the Word document
Document doc = new Document(dataDir + @"input.docx", lo);
 
//Save the document into DOCX
doc.Save(dataDir + "output.docx", SaveFormat.Docx);

保存前更新LastSavedTime屬性

使用SaveOptions.UpdateLastSavedTimeProperty屬性是否在保存文檔時更新相應的內置文檔屬性（BuiltInDocumentProperties.LastSavedTime）。 下面的示例顯示如何更新此屬性。

Document doc = new Document(dataDir + "Document.doc");

OoxmlSaveOptions options = new OoxmlSaveOptions();
options.UpdateLastSavedTimeProperty = true;

dataDir = dataDir + "UpdateLastSavedTimeProperty_out.docx";

// Save the document to disk.
doc.Save(dataDir, options);

調用UpdateFields會更新所有字段類型

在以前的版本中，調用Document.UpdateFields或Range.UpdateFields只會更新常規字段（例如IF或DOCPROPERTY），而不會更新與頁面布局相關的字段（例如PAGE或NUMPAGES）。現在，較新的版本將更新常規和頁面布局相關的字段。當Document.UpdateFields或Range.UpdateFields被稱為所有字段在整個文件/范圍更新。如果在更新過程中遇到與頁面布局相關的字段（例如PAGE字段），則可能涉及構建文檔布局。 下例顯示了如何更新文檔中的所有字段。

// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_WorkingWithFields();

Document doc = new Document(dataDir + "Rendering.doc");

// This updates all fields in the document.
doc.UpdateFields();
dataDir = dataDir + "Rendering.UpdateFields_out.pdf";
doc.Save(dataDir);

刪除字段

如前所述，所有字段現在都使用Document.UpdateFields更新。現在，這意味著更新文檔中字段的更簡潔明了的方法。這也意味著在諸如更新TOC字段之類的情況下，不再需要對Document.UpdatePageLayout的任何調用。所有工作都在Document.UpdateFields調用中處理。 下面的示例顯示如何通過調用字段更新來完全重建文檔中的TOC字段。

// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_WorkingWithFields();

Document doc = new Document(dataDir + "Field.RemoveField.doc");

Field field = doc.Range.Fields[0];
// Calling this method completely removes the field from the document.
field.Remove();

---

還想要更多嗎？您可以點擊閱讀【2020 · Aspose最新資源整合】，查找需要的教程資源。如果您有任何疑問或需求，請隨時加入Aspose技術交流群（642018183），我們很高興為您提供查詢和咨詢。