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

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto Proyectos de nivel de documento Versión de Microsoft Office Excel 2007 Word 2007 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

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, consulte Información general sobre los elementos XML personalizados.

Nota:
Visual Studio Tools para Office no proporciona los 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 Microsoft.Office.Core.CustomXMLPart nuevo a la colección Microsoft.Office.Core.CustomXMLParts del libro. Microsoft.Office.Core.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 2007.

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 Microsoft.Office.Core.CustomXMLPart nuevo a la colección Microsoft.Office.Core.CustomXMLParts del documento. Microsoft.Office.Core.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 2007.

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

Cómo: Agregar elementos XML personalizados a documentos sin iniciar Microsoft Office

Conceptos

Información general sobre los elementos XML personalizados