Como: Adicionar Parts XML de Personalizars a documentos usando suplementos de nível de aplicativo

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Versão do Microsoft Office O Excel 2007 PowerPoint 2007 Word 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de aplicativo

Versão do Microsoft Office

O Excel 2007
PowerPoint 2007
Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode armazenar dados XML nos seguintes tipos de documentos, criando uma parte XML Personalizar em um nível de aplicativo Adicionar - in:

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

For more information, see Visão geral de Parts XML Personalizar.

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

Adicionar um novo objeto de Microsoft.Office.Core.CustomXMLPart à coleção Microsoft.Office.Core.CustomXMLParts na pasta de trabalho.O Microsoft.Office.Core.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 XML Personalizar 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 método de AddCustomXmlPartToWorkbook à classe ThisAddIn em um projeto de nível de aplicativo para o Excel 2007.
Chame o método de outro código em seu projeto.Por exemplo, para criar a parte XML Personalizar quando o usuário abre uma pasta de trabalho, chamar o método de um manipulador de eventos para o evento Microsoft.Office.Interop.Excel.Application.WorkbookOpen.

Para adicionar uma parte XML Personalizar a um documento do Word

Adicionar um novo objeto de Microsoft.Office.Core.CustomXMLPart à coleção Microsoft.Office.Core.CustomXMLParts no documento.O Microsoft.Office.Core.CustomXMLPart contém a Cadeia de Caracteres XML que você deseja armazenar no documento.

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

Adicionar o método de AddCustomXmlPartToDocument à classe ThisAddIn em um projeto de nível de aplicativo para Word 2007.
Chame o método de outro código em seu projeto.Por exemplo, para criar a parte XML Personalizar quando o usuário abre um documento, chamar o método de um manipulador de eventos para o evento Microsoft.Office.Interop.Word.Application.DocumentOpen.

Para adicionar uma parte XML Personalizar a uma apresentação do PowerPoint

Adicionar um novo objeto de Microsoft.Office.Core.CustomXMLPart à coleção Microsoft.Office.Core.CustomXMLParts na apresentação.O Microsoft.Office.Core.CustomXMLPart contém a Cadeia de Caracteres XML que deseja armazenar na apresentação.

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

Adicionar o método de AddCustomXmlPartToPresentation à classe ThisAddIn em um projeto de nível de aplicativo para o PowerPoint 2007.
Chame o método de outro código em seu projeto.Por exemplo, para criar a parte XML Personalizar quando o usuário abre uma apresentação, chamar o método de um manipulador de eventos para o evento Microsoft.Office.Interop.PowerPoint.Application.AfterPresentationOpen.

Programação robusta

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

Consulte também

Tarefas

Como: Adicionar Parts XML personalizado a personalizações de nível de documento

Como: Adicionar Parts XML de Personalizars a documentos sem iniciar o Microsoft Office

Conceitos

Visão geral de Parts XML Personalizar

Compartilhar via