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

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 aplicación

Versión de Microsoft Office

  • Excel 2007

  • PowerPoint 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 los siguientes tipos de documento creando un elemento XML personalizado en un complemento de nivel de aplicación:

  • Un libro de Microsoft Office Excel.

  • Un documento de Microsoft Office Word.

  • Una presentación de Microsoft Office PowerPoint.

Para obtener más información, consulte Información general sobre los elementos XML personalizados.

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.

    En el ejemplo de código siguiente se agrega un elemento XML personalizado al libro especificado.

    Private Sub AddCustomXmlPartToWorkbook(ByVal workbook As Excel.Workbook)
    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 = _
        workbook.CustomXMLParts.Add(xmlString)
End Sub

    private void AddCustomXmlPartToWorkbook(Excel.Workbook workbook)
{
    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 = workbook.CustomXMLParts.Add(xmlString, missing);
}

  2. Agregue el método AddCustomXmlPartToWorkbook a la clase ThisAddIn en un proyecto de nivel de aplicación para Excel 2007.

  3. Llame al método desde otro fragmento de código del proyecto. Por ejemplo, para que se cree el elemento XML personalizado cuando el usuario abra un libro, llame al método desde el controlador de eventos para el evento Microsoft.Office.Interop.Excel.Application.WorkbookOpen.

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.

    En el ejemplo de código siguiente se agrega un elemento XML personalizado al documento especificado.

    Private Sub AddCustomXmlPartToActiveDocument(ByVal document As Word.Document)
    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 = _
        document.CustomXMLParts.Add(xmlString)
End Sub

    private void AddCustomXmlPartToActiveDocument(Word.Document document)
{
    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 = document.CustomXMLParts.Add(xmlString, missing);
}

  2. Agregue el método AddCustomXmlPartToDocument a la clase ThisAddIn en un proyecto de nivel de aplicación para Word 2007.

  3. Llame al método desde otro fragmento de código del proyecto. Por ejemplo, para que se cree el elemento XML personalizado cuando el usuario abra un documento, llame al método desde el controlador de eventos para el evento Microsoft.Office.Interop.Word.Application.DocumentOpen.

Para agregar un elemento XML personalizado a una presentación de PowerPoint

  1. Agregue un objeto Microsoft.Office.Core.CustomXMLPart nuevo a la colección Microsoft.Office.Core.CustomXMLParts de la presentación. Microsoft.Office.Core.CustomXMLPart contiene la cadena XML que desea almacenar en la presentación.

    En el ejemplo de código siguiente se agrega un elemento XML personalizado a la presentación especificada.

    Private Sub AddCustomXmlPartToPresentation(ByVal presentation As PowerPoint.Presentation)
    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 = _
        presentation.CustomXMLParts.Add(xmlString)
End Sub

    private void AddCustomXmlPartToPresentation(PowerPoint.Presentation presentation)
{
    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 = 
        presentation.CustomXMLParts.Add(xmlString, missing);
}

  2. Agregue el método AddCustomXmlPartToPresentation a la clase ThisAddIn en un proyecto de nivel de aplicación para PowerPoint 2007.

  3. Llame al método desde otro fragmento de código del proyecto. Por ejemplo, para que se cree el elemento XML personalizado cuando el usuario abra una presentación, llame al método desde el controlador de eventos para el evento Microsoft.Office.Interop.PowerPoint.Application.AfterPresentationOpen.

Programación eficaz

Para simplificar, en este ejemplo se utiliza una cadena XML que se define como una variable local del método. Normalmente, se 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 personalizaciones de nivel de documento

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

Conceptos

Información general sobre los elementos XML personalizados

  • Last updated on