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

Artigo
02/25/2013

Você pode armazenar dados XML em uma pasta de trabalho do Microsoft Office Excel ou em um documento Microsoft Office Word criando uma parte personalizado XML em uma personalização da nível.Para obter mais informações, consulte Visão geral de partes XML personalizada.

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

Observação
Visual Studio não fornece projetos da nível do Microsoft Office PowerPoint.Para obter informações sobre como adicionar uma parte personalizado XML a uma apresentação do Powerpoint usando um suplemento ao aplicativo, consulte Como: adicionar partes XML personalizado aos documentos usando suplementos de nível de aplicativo.

Para adicionar XML personalizado parte 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.

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

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

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.

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

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

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 aos documentos usando suplementos de nível de aplicativo

Conceitos

Visão geral de partes XML personalizada

Partilhar via