Como: Adicionar partes XML personalizado aos documentos usando suplementos de nível de aplicativo

Artigo
08/08/2011

Você pode armazenar dados XML nos seguintes tipos de documentos, criando uma parte XML personalizada em um suplemento em nível de aplicativo:

Uma pasta de trabalho do Excel de Microsoft Office.
Um documento do Word de Microsoft Office.
Uma apresentação do PowerPoint de Microsoft Office.

For more information, see Visão geral de partes XML personalizada.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para os seguintes aplicativos: Excel 2007 e Excel 2010; PowerPoint 2007 e PowerPoint 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Para adicionar um componente XML personalizado para uma pasta de trabalho do Excel

Adicionar um novo CustomXMLPart o objeto para o CustomXMLParts a coleção na pasta de trabalho. O CustomXMLPart contém a seqüência XML que você deseja armazenar na pasta de trabalho.

O exemplo de código a seguir adiciona um componente XML personalizado para uma pasta de trabalho especificada.

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);
}

Adicionar o AddCustomXmlPartToWorkbook método para o ThisAddIn a classe em um projeto de nível de aplicativo para o Excel.
Chame o método a partir de outro código no seu projeto. Por exemplo, para criar a parte XML personalizada quando o usuário abre uma pasta de trabalho, chame o método de um manipulador de eventos para o WorkbookOpen de evento.

Para adicionar um componente XML personalizado a um documento do Word

Adicionar um novo CustomXMLPart o objeto para o CustomXMLParts a coleção do documento. O CustomXMLPart contém a seqüência XML que você deseja armazenar no documento.

O exemplo de código a seguir adiciona uma parte XML personalizada para um 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);
}

Adicionar o AddCustomXmlPartToDocument método para o ThisAddIn a classe em um projeto de nível de aplicativo para o Word.
Chame o método a partir de outro código no seu projeto. Por exemplo, para criar a parte XML personalizada quando o usuário abre um documento, chame o método de um manipulador de eventos para o DocumentOpen de evento.

Para adicionar um componente XML personalizado para uma apresentação do PowerPoint

Adicionar um novo CustomXMLPart o objeto para o CustomXMLParts a coleção na apresentação. O CustomXMLPart contém a seqüência XML que você deseja armazenar na apresentação.

O exemplo de código a seguir adiciona um componente XML personalizado para uma apresentação 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);
}

Adicionar o AddCustomXmlPartToPresentation método para o ThisAddIn a classe em um projeto de nível de aplicativo para o PowerPoint.
Chame o método a partir de outro código no seu projeto. Por exemplo, para criar a parte XML personalizada quando o usuário abre uma apresentação, chame o método de um manipulador de eventos para o AfterPresentationOpen de evento.

Programação robusta

Para simplificar, este exemplo usa uma cadeia XML que é definida como uma variável local no método. Normalmente, você deve obter o XML de uma fonte externa, como, por exemplo, um arquivo ou um banco de dados.

Consulte também

Tarefas

Como: Adicionar partes XML personalizado para personalizações em nível de documento

Como: Adicionar partes XML personalizado para documentos sem iniciar o Microsoft Office

Conceitos

Visão geral de partes XML personalizada

Compartilhar via