通过

将自定义 XML 部件添加到文档级自定义

  • 项目

你可以通过在文档级自定义中创建自定义 XML 部件将 XML 数据存储在 Microsoft Office Excel 工作表或 Microsoft Office Word 文档中。 有关详细信息，请参阅 自定义 XML 部件概述。

适用于： 本主题中的信息适用于 Excel 和 Word 的文档级项目。 有关详细信息，请参阅办公室应用程序和项目类型提供的功能。

注意

Visual Studio 不提供 Microsoft Office PowerPoint 的文档级项目。 有关使用 VSTO 外接程序将自定义 XML 部件添加到 PowerPoint 演示文稿的信息，请参阅 How to： Add custom XML parts to documents by using VSTO Add-ins.

向 Excel 工作簿添加自定义 XML 部件

  1. 向工作簿中的 CustomXMLPart 集合添加新 CustomXMLParts 对象。 CustomXMLPart 包含你希望存储在工作簿中的 XML 字符串。

    private void AddCustomXmlPartToWorkbook()
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"http://schemas.microsoft.com/vsto/samples\">" +
            "<employee>" +
                "<name>Karina Leal</name>" +
                "<hireDate>1999-04-01</hireDate>" +
                "<title>Manager</title>" +
            "</employee>" +
        "</employees>";

    Office.CustomXMLPart employeeXMLPart = this.CustomXMLParts.Add(xmlString, missing);
}

  2. 将 AddCustomXmlPartToWorkbook 方法添加到 Excel 文档级项目中的 ThisWorkbook 类。

  3. 从项目中的其他代码调用该方法。 例如，若要在用户打开工作簿时创建自定义 XML 部件，则从 ThisWorkbook_Startup 事件处理程序调用该方法。

向 Word 文档添加自定义 XML 部件

  1. 向文档中的 CustomXMLPart 集合添加新的 CustomXMLParts 对象。 CustomXMLPart 包含你希望存储在文档中的 XML 字符串。

    private void AddCustomXmlPartToDocument()
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"http://schemas.microsoft.com/vsto/samples\">" +
            "<employee>" +
                "<name>Karina Leal</name>" +
                "<hireDate>1999-04-01</hireDate>" +
                "<title>Manager</title>" +
            "</employee>" +
        "</employees>";

    Office.CustomXMLPart employeeXMLPart = this.CustomXMLParts.Add(xmlString, missing);
}

  2. 将 AddCustomXmlPartToDocument 方法添加到 Word 文档级项目中的 ThisDocument 类。

  3. 从项目中的其他代码调用该方法。 例如，若要在用户打开文档时创建自定义 XML 部件，则从 ThisDocument_Startup 事件处理程序调用该方法。

可靠编程

为简单起见，此示例使用在方法中定义为局部变量的 XML 字符串。 通常，应从外部源（如文件或数据库）获取 XML。

相关内容