Adicionar partes XML personalizadas a personalizações em nível de documento

  • Artigo

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

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel e Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Observação

Visual Studio não fornece projetos de nível de documento para o Microsoft Office PowerPoint. Para obter informações sobre como adicionar uma parte XML personalizada a uma apresentação do PowerPoint usando um suplemento VSTO, consulte Como adicionar partes XML personalizadas a documentos usando suplementos VSTO.

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

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

    private void AddCustomXmlPartToWorkbook()
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"http://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);
}

  2. Adicione o AddCustomXmlPartToWorkbook método à ThisWorkbook classe em um projeto de nível de documento para Excel.

  3. Chame o método de outro código em seu projeto. Por exemplo, para criar a parte XML personalizada quando o usuário abre a pasta de trabalho, chame o método do manipulador de ThisWorkbook_Startup eventos.

Para adicionar uma parte XML personalizada a um documento do Word

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

    private void AddCustomXmlPartToDocument()
{
    string xmlString =
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
        "<employees xmlns=\"http://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);
}

  2. Adicione o AddCustomXmlPartToDocument método à classe em um projeto de nível de documento para o ThisDocument Word.

  3. Chame o método de outro código em seu projeto. Por exemplo, para criar a parte XML personalizada quando o usuário abre o documento, chame o método do manipulador de ThisDocument_Startup eventos.

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 uma fonte externa, como um arquivo ou um banco de dados.

Conteúdo relacionado