在 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 部分
现在，通过调用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 部分分配唯一的标识符，以方便以后轻松检索：
//为自定义 XML 部分分配 ID。
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 库，使开发人员无需安装 Microsoft Excel 即可创建、操作和转换 Excel 文件。
我可以免费使用 Aspose.Cells 吗？
是的！你可以先免费试用一下。只需点击下载.
是否可以向工作簿添加多个自定义 XML 部分？
当然可以！您可以根据需要添加任意数量的自定义 XML 部分，每个部分都有唯一的 ID 以便于访问。
如果我不知道 ID，如何检索 XML 部分？
如果你不知道 ID，你可以循环遍历CustomXmlParts集合来查看可用的部件及其 ID，使识别更加容易。
在哪里可以找到有关 Aspose.Cells 的更多资源或支持？
这行简单的代码初始化了一个新的工作簿，我们可以在其中添加自定义的 XML 部分。
第 2 步：准备 XML 数据和架构
接下来，您需要准备一些字节数组形式的数据。虽然我们的示例使用了占位符数据，但在实际情况下，您需要将这些字节数组替换为要集成到工作簿中的实际 XML 数据和架构。
//一些字节数组形式的数据。
//请使用正确的 XML 和 Schema。
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 部分。
//为自定义 xml 部分分配 ID。
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，从而更容易识别和访问它们。