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

Artigo
08/08/2011

Você pode armazenar dados XML em uma pasta de trabalho do Excel de Microsoft Office ou um documento do Word de Microsoft Office criando um componente XML personalizado em uma personalização em nível de documento. 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 documento para os seguintes aplicativos: Excel 2007 e Excel 2010; Word 2007 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 oferece projetos de nível de documento do PowerPoint de Microsoft Office. Para obter informações sobre como adicionar um componente XML personalizado para uma apresentação do PowerPoint usando-se um suplemento em nível de aplicativo, consulte Como: Adicionar partes XML personalizado aos documentos usando suplementos de nível de aplicativo.

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.

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

Adicionar o AddCustomXmlPartToWorkbook método para o ThisWorkbook a classe em um projeto de nível de documento 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 a pasta de trabalho, chamar o método a partir de ThisWorkbook_Startup manipulador de eventos.

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.

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

Adicionar o AddCustomXmlPartToDocument método para o ThisDocument a classe em um projeto de nível de documento para 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 o documento, chamar o método a partir de ThisDocument_Startup manipulador de eventos.

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

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

Conceitos

Visão geral de partes XML personalizada

Compartilhar via