在 Excel 工作簿中新增自訂 XML 部分
介紹
當談到以程式設計方式管理 Excel 檔案時，Aspose.Cells for .NET 是一個出色的函式庫。其令人興奮的功能之一是能夠將自訂 XML 部分整合到 Excel 工作簿中。本指南將引導您完成新增具有唯一 ID 的自訂 XML 元件並在需要時擷取它們的流程。讓我們開始吧！
先決條件
在深入研究程式碼之前，請確保您已進行以下設定：
- Visual Studio：確保您的電腦上安裝了 Visual Studio 以進行編碼。
- Aspose.Cells for .NET：您需要安裝此程式庫。如果您還沒有這樣做，您可以在這裡下載.
- .NET Framework：熟悉 .NET 架構和 C# 將會有所幫助。
一切準備就緒後，讓我們開始編碼吧！
導入所需的套件
若要使用 Aspose.Cells，請在程式碼頂部新增必要的命名空間：
using System;
using Aspose.Cells;
這允許您存取 Aspose.Cells 提供的所有功能。
第 1 步：建立一個空白工作簿
首先建立一個實例Workbook類，代表您的 Excel 工作簿：
//建立一個空工作簿。
Workbook wb = new Workbook();
這將初始化一個新工作簿，您可以在其中新增自訂 XML 部分。
第 2 步：準備 XML 資料和架構
接下來，將 XML 資料和模式準備為位元組數組。雖然此範例使用佔位符數據，但您應該將其替換為實際的 XML 內容。
//位元組數組形式的範例資料。
byte[] btsData = System.Text.Encoding.UTF8.GetBytes("<root><data>Example</data></root>");
byte[] btsSchema = System.Text.Encoding.UTF8.GetBytes("<root><data></data></root>");
第 3 步：新增自訂 XML 部分
現在，透過呼叫將自訂 XML 部分新增至工作簿中Add方法上的CustomXmlParts收藏：
//將自訂 XML 部分新增至工作簿。
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
此程式碼片段新增了四個相同的自訂 XML 部分。您可以根據您的要求對此進行自訂。
步驟 4：為自訂 XML 元件指派唯一 ID
為每個 XML 部分指派唯一的標識符，以便於日後輕鬆檢索：
//將 ID 指派給自訂 XML 部分。
wb.CustomXmlParts[0].ID = "Fruit";
wb.CustomXmlParts[1].ID = "Color";
wb.CustomXmlParts[2].ID = "Sport";
wb.CustomXmlParts[3].ID = "Shape";
這些有意義的 ID 將幫助您稍後識別各個部分。
步驟 5：指定自訂 XML 部件的搜尋 ID
若要擷取特定的 XML 部分，請定義您要搜尋的 ID：
//指定搜尋自訂 XML 部件 ID。
string srchID = "Fruit"; //根據需要將其更改為其他 ID
步驟 6：按 ID 搜尋自訂 XML 元件
現在，使用指定的 ID 搜尋自訂 XML 部分：
//透過搜尋 ID 搜尋自訂 XML 部分。
CustomXmlPart cxp = wb.CustomXmlParts.SelectByID(srchID);
這條線使用SelectByID尋找與指定 ID 關聯的 XML 部分。
第 7 步：檢查是否找到自訂 XML 部分
最後，檢查是否找到 XML 部分並列印相應的訊息：
//將找到或未找到的訊息列印到控制台。
if (cxp == null)
{
Console.WriteLine("Not Found: CustomXmlPart ID " + srchID);
}
else
{
Console.WriteLine("Found: CustomXmlPart ID " + srchID);
}
Console.WriteLine("AddCustomXMLPartsAndSelectThemByID executed successfully.");
恭喜！您已成功將自訂 XML 元件新增至工作簿並實現了按 ID 搜尋它們的功能。
結論
在本文中，我們探討如何使用 Aspose.Cells for .NET 將自訂 XML 元件新增至 Excel 工作簿。透過遵循本逐步指南，您學習如何建立工作簿、新增自訂 XML 部分、分配 ID 以及有效率地檢索它們。此功能對於處理 Excel 檔案中的動態資料、增強應用程式的功能非常有用。
常見問題解答
什麼是 Aspose.Cells？
Aspose.Cells 是一個功能強大的.NET 程式庫，可讓開發人員建立、操作和轉換 Excel 文件，而無需安裝 Microsoft Excel。
我可以免費使用 Aspose.Cells 嗎？
是的！您可以從免費試用版開始。只是在這裡下載.
是否可以將多個自訂 XML 部分新增至工作簿？
絕對地！您可以根據需要新增任意數量的自訂 XML 部分，每個部分都有唯一的 ID，以便於存取。
如果我不知道 ID，如何檢索 XML 部分？
如果你不知道ID，你可以循環遍歷CustomXmlParts收集以查看可用零件及其 ID，使識別更加容易。
在哪裡可以找到有關 Aspose.Cells 的更多資源或支援？
這個簡單的行初始化了一個新的工作簿，我們可以在其中新增自訂 XML 部分。
第 2 步：準備 XML 資料和架構
接下來，您需要準備一些位元組數組形式的資料。儘管我們的範例使用佔位符數據，但在現實場景中，您可以將這些位元組數組替換為要整合到工作簿中的實際 XML 資料和架構。
//一些資料以位元組數組的形式存在。
//請改用正確的 XML 和架構。
byte[] btsData = new byte[] { 1, 2, 3 };
byte[] btsSchema = new byte[] { 1, 2, 3 };
請記住，雖然此範例使用簡單的位元組數組，但您通常會在此處使用有效的 XML 和架構。
第 3 步：新增自訂 XML 部分
現在是時候將自訂 XML 部分新增至工作簿了。您可以透過呼叫來做到這一點Add方法上的CustomXmlParts作業簿的集合。
//建立四個自訂 xml 部分。
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
此程式碼片段會為工作簿新增四個相同的自訂 XML 部分。您可以根據您的要求對此進行自訂。
步驟 4：為自訂 XML 部件指派 ID
現在我們已經新增了 XML 部分，讓我們為每個部分指定一個唯一的識別碼。該 ID 將幫助我們稍後檢索 XML 部分。
//將 id 指派給自訂 xml 部分。
wb.CustomXmlParts[0].ID = "Fruit";
wb.CustomXmlParts[1].ID = "Color";
wb.CustomXmlParts[2].ID = "Sport";
wb.CustomXmlParts[3].ID = "Shape";
在此步驟中，您將指派有意義的 ID，例如「水果」、「顏色」、「運動」和「形狀」。這樣以後就可以輕鬆辨識和使用各個零件。
步驟 5：指定自訂 XML 部件的搜尋 ID
當您想要使用 ID 檢索特定 XML 部分時，您需要定義要搜尋的 ID。
//指定搜尋自訂 xml 部件 ID。
String srchID = "Fruit";
srchID = "Color";
srchID = "Sport";
在實際應用程式中，您可能想要動態指定每個 ID，但對於我們的範例，我們對一些 ID 進行硬編碼。
步驟 6：按 ID 搜尋自訂 XML 元件
現在我們有了搜尋 ID，是時候尋找與指定 ID 相對應的自訂 XML 部分了。
//透過搜尋 ID 搜尋自訂 xml 部分。
Aspose.Cells.Markup.CustomXmlPart cxp = wb.CustomXmlParts.SelectByID(srchID);
這條線利用了SelectByID嘗試尋找我們感興趣的 XML 部分。
第 7 步：檢查是否找到自訂 XML 部分
最後，我們需要檢查是否找到 XML 部分並將適當的訊息列印到控制台。
//在控制台上列印找到或未找到的訊息。
if (cxp == null)
{
Console.WriteLine("Not Found: CustomXmlPart ID " + srchID);
}
else
{
Console.WriteLine("Found: CustomXmlPart ID " + srchID);
}
Console.WriteLine("AddCustomXMLPartsAndSelectThemByID executed successfully.");
你把它壓扁了！至此，您不僅已將自訂 XML 元件新增至工作簿中，而且還實現了按 ID 搜尋它們的功能。
結論
在本文中，我們探討如何使用 Aspose.Cells for .NET 將自訂 XML 元件新增至 Excel 工作簿。透過遵循逐步指南，您能夠建立工作簿、新增自訂 XML 部分、指派 ID 並有效率地擷取它們。在處理需要在 Excel 文件中處理的動態資料時，此功能非常有用，使您的應用程式更聰明、更強大。
常見問題解答
什麼是 Aspose.Cells？
Aspose.Cells 是一個強大的 .NET 程式庫，可讓開發人員建立、操作和轉換 Excel 文件，而無需安裝 Microsoft Excel。
我可以免費使用 Aspose.Cells 嗎？
是的！您可以從免費試用版開始。只是在這裡下載.
是否可以將多個自訂 XML 部分新增至工作簿？
絕對地！您可以根據需要新增任意數量的自訂 XML 部分，並且可以為每個部分指派唯一的 ID 以方便存取。
如果我不知道 ID，如何檢索 XML 部分？
如果你不知道ID，你可以循環遍歷CustomXmlParts集合以查看可用部件及其 ID，從而更輕鬆地識別和存取它們。