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

Artigo
02/25/2013

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

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

Para obter mais informações, consulte Visão geral de partes XML personalizada.

Se aplica: as informações contidas em este tópico aplica projetos no nível para os seguintes aplicativos: Excel 2010; O Powerpoint 2010; palavras 2010.Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Para adicionar uma parte personalizado XML a uma pasta de trabalho do Excel

Adicione um novo objeto de CustomXMLPart à coleção de CustomXMLParts na pasta de trabalho.CustomXMLPart contém a cadeia de caracteres XML que você deseja armazenar na pasta de trabalho.

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

Adicione o método de AddCustomXmlPartToWorkbook a classe de ThisAddIn em um projeto do nível para o excel.
Chame o método de outro código em seu projeto.Por exemplo, para criar XML personalizado parte quando o usuário abre uma pasta de trabalho, chama o método de um manipulador de eventos para o evento de WorkbookOpen .

Para adicionar uma parte personalizado XML a um documento do word

Adicione um novo objeto de CustomXMLPart à coleção de CustomXMLParts no documento.CustomXMLPart contém a cadeia de caracteres de XML que você deseja armazenar no documento.

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

Adicione o método de AddCustomXmlPartToDocument a classe de ThisAddIn em um projeto do nível para palavra.
Chame o método de outro código em seu projeto.Por exemplo, para criar XML personalizado parte quando o usuário abrir um documento, chama o método de um manipulador de eventos para o evento de DocumentOpen .

Para adicionar XML personalizado parte ao Powerpoint uma apresentação

Adicione um novo objeto de CustomXMLPart à coleção de CustomXMLParts a apresentação.CustomXMLPart contém a cadeia de caracteres XML que você deseja armazenar a apresentação.

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

Adicione o método de AddCustomXmlPartToPresentation a classe de ThisAddIn em um projeto do nível para o Powerpoint.
Chame o método de outro código em seu projeto.Por exemplo, para criar XML personalizado parte quando o usuário abre uma apresentação, chama o método de um manipulador de eventos para o evento de AfterPresentationOpen .

Programação robusta

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

Consulte também

Tarefas

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

Conceitos

Visão geral de partes XML personalizada

Compartilhar via