結構化文檔標記範圍起始 Xml 映射

介紹

您是否曾經想過將 XML 資料動態插入到 Word 文件中？嗯，你很幸運！ Aspose.Words for .NET 讓這項任務變得輕而易舉。在本教學中，我們將深入探討結構化文件標記範圍起始 XML 對應。此功能可讓您將自訂 XML 部分綁定到內容控件，確保您的文件內容與 XML 資料無縫更新。準備好將您的文件轉變為動態傑作。

先決條件

在我們進入編碼部分之前，讓我們確保您擁有所需的一切：

  1. Aspose.Words for .NET Library：確保您擁有最新版本。你可以下載它這裡.
  2. 開發環境：Visual Studio 或任何其他支援 C# 的 IDE。
  3. C# 基礎知識：必須熟悉 C# 程式設計。
  4. Word 文件：可供使用的範例 Word 文件。

導入命名空間

首先，讓我們導入必要的名稱空間。這將確保我們能夠存取 Aspose.Words for .NET 中所有必要的類別和方法。

using System;
using Aspose.Words;
using Aspose.Words.Markup;
using System.Text;

第 1 步：設定您的文件目錄

每個項目都需要一個基礎，對嗎？在這裡，我們設定文檔目錄的路徑。

//文檔目錄的路徑
string dataDir = "YOUR DOCUMENT DIRECTORY";

步驟2：載入Word文檔

接下來，我們載入Word文檔。這是我們將插入 XML 資料的文檔。

Document doc = new Document(dataDir + "Multi-section structured document tags.docx");

第 3 步：新增自訂 XML 部分

我們需要建構一個包含要插入的資料的 XML 元件，並將其新增至文件的 CustomXmlPart 集合中。這個自訂 XML 部分將用作我們的結構化文件標籤的資料來源。

建立 XML 部件

首先，為 XML 部分產生唯一 ID 並定義其內容。

//建構一個包含資料的 XML 元件並將其新增至文件的 CustomXmlPart 集合中。
string xmlPartId = Guid.NewGuid().ToString("B");
string xmlPartContent = "<root><text>Text element #1</text><text>Text element #2</text></root>";
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(xmlPartId, xmlPartContent);

驗證 XML 部分內容

為了確保正確添加 XML 部分，我們列印其內容。

Console.WriteLine(Encoding.UTF8.GetString(xmlPart.Data));

步驟 4：建立結構化文件標籤

結構化文件標籤 (SDT) 是可以綁定到 XML 部分的內容控制項。在這裡，我們建立一個 SDT，它將顯示自訂 XML 部分的內容。

首先，找到文件中 SDT 範圍的起始位置。

StructuredDocumentTagRangeStart sdtRangeStart = (StructuredDocumentTagRangeStart)doc.GetChild(NodeType.StructuredDocumentTagRangeStart, 0, true);

步驟 5：為 SDT 設定 XML 映射

現在，是時候將 XML 部分綁定到 SDT 了。透過設定 XML 映射，我們指定 XML 資料的哪一部分應顯示在 SDT 中。

XPath 指向我們要顯示的 XML 部分中的特定元素。這裡，我們指向第二個<text>內的元素<root>元素。

//為我們的 StructuredDocumentTag 設定映射
sdtRangeStart.XmlMapping.SetMapping(xmlPart, "/root[1]/text[2]", null);

第 6 步：儲存文檔

最後，儲存文件以查看實際變更。 Word 文件中的 SDT 現在將顯示指定的 XML 內容。

doc.Save(dataDir + "WorkingWithSdt.StructuredDocumentTagRangeStartXmlMapping.docx");

結論

現在你就擁有了！您已使用 Aspose.Words for .NET 成功將 XML 部分對應到 Word 文件中的結構化文件標記。這項強大的功能使您能夠輕鬆建立動態和資料驅動的文件。無論您是產生報表、發票或任何其他文件類型，XML 對應都可以顯著簡化您的工作流程。

常見問題解答

Word 中的結構化文件標籤是什麼？

結構化文件標籤也稱為內容控件，是 Word 文件中特定類型內容的容器。它們可用於綁定資料、限制編輯或指導使用者建立文件。

如何動態更新XML部分內容？

您可以透過修改以下內容來更新 XML 部分內容xmlPartContent字串，然後將其添加到文件中。只需使用新資料更新字串並將其新增至CustomXmlParts收藏。

我可以將多個 XML 部分綁定到同一文件中的不同 SDT 嗎？

是的，您可以將多個 XML 部分綁定到同一文件中的不同 SDT。每個 SDT 都可以有自己獨特的 XML 部分和 XPath 映射。

是否可以將複雜的 XML 結構對應到 SDT？

絕對地！您可以使用詳細的 XPath 表達式將複雜的 XML 結構對應到 SDT，這些表達式精確地指向 XML 部分中所需的元素。

如何從文件中刪除 XML 部分？

您可以透過呼叫刪除 XML 部分Remove方法上的CustomXmlParts集合，透過xmlPartId您要刪除的 XML 部分的名稱。