Cómo: Agregar elementos XML personalizados a personalizaciones de nivel de documento

Puede almacenar datos XML en un libro de Microsoft Office Excel o en un documento de Microsoft Office Word creando un elemento XML personalizado en una personalización de nivel de documento.Para obtener más información, vea Información general sobre los elementos XML personalizados.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de documento para las siguientes aplicaciones: Excel 2013 y Excel 2010; Word 2013 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

[!NOTA]

Visual Studio no proporciona proyectos de nivel de documento para Microsoft Office PowerPoint.Para obtener información sobre cómo agregar un elemento XML personalizado a una presentación de PowerPoint utilizando un complemento de nivel de aplicación, vea Cómo: Agregar elementos XML personalizados a documentos mediante complementos de nivel de aplicación.

Para agregar un elemento XML personalizado a un libro de Excel

1. Agregue un objeto CustomXMLPart nuevo a la colección CustomXMLParts del libro.CustomXMLPart contiene la cadena XML que desea almacenar en el libro.

   Private Sub AddCustomXmlPartToWorkbook()
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                   "<employee>" & _
                       "<name>Karina Leal</name>" & _
                       "<hireDate>1999-04-01</hireDate>" & _
                       "<title>Manager</title>" & _
                   "</employee>" & _
               "</employees>"
       Dim employeeXMLPart As Office.CustomXMLPart = Me.CustomXMLParts.Add(xmlString)
   End Sub
   

   private void AddCustomXmlPartToWorkbook()
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"https://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. Agregue el método AddCustomXmlPartToWorkbook a la clase ThisWorkbook en un proyecto de nivel de documento para Excel.

3. Llame al método desde otro fragmento de código del proyecto.Por ejemplo, para crear el elemento XML personalizado cuando el usuario abra el libro, llame al método desde el controlador de eventos ThisWorkbook_Startup.

Para agregar un elemento XML personalizado a un documento de Word

1. Agregue un objeto CustomXMLPart nuevo a la colección CustomXMLParts del documento.CustomXMLPart contiene la cadena XML que desea almacenar en el documento.

   Private Sub AddCustomXmlPartToDocument()
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                   "<employee>" & _
                       "<name>Karina Leal</name>" & _
                       "<hireDate>1999-04-01</hireDate>" & _
                       "<title>Manager</title>" & _
                   "</employee>" & _
               "</employees>"
   
       Dim employeeXMLPart As Office.CustomXMLPart = _
           Me.CustomXMLParts.Add(xmlString)
   End Sub
   

   private void AddCustomXmlPartToDocument()
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"https://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. Agregue el método AddCustomXmlPartToDocument a la clase ThisDocument en un proyecto de nivel de documento para Word.

3. Llame al método desde otro fragmento de código del proyecto.Por ejemplo, para crear el elemento XML personalizado cuando el usuario abra el documento, llame al método desde el controlador de eventos ThisDocument_Startup.

Programación eficaz

Por simplificar, en este ejemplo se utiliza una cadena XML que se define como una variable local del método.Normalmente, debe obtener el XML de un origen externo, por ejemplo, un archivo o una base de datos.

Vea también

Tareas

Cómo: Agregar elementos XML personalizados a documentos mediante complementos de nivel de aplicación

Conceptos

Información general sobre los elementos XML personalizados