Visão geral de partes XML personalizadas

  • Artigo

Você pode incorporar dados XML em documentos para alguns aplicativos do Microsoft Office. Quando você incorpora dados XML em um documento, os dados são nomeados uma parte XML personalizada.

Você pode criar e modificar partes XML personalizadas em um documento usando um suplemento VSTO ou solução de nível de documento no Visual Studio. Não é necessário iniciar o aplicativo Microsoft Office para criar e modificar partes XML personalizadas.

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

Observação

O Visual Studio também permite que você armazene objetos de dados em cache em personalizações em nível de documento. Esse recurso é diferente das partes XML personalizadas, embora haja algumas semelhanças. Para obter mais informações, consulte Dados armazenados em cache em personalizações em nível de documento.

Compreender partes XML personalizadas

Partes XML personalizadas foram introduzidas no 2007 Microsoft Office System, juntamente com os Formatos Open XML. Esses formatos incluem novos formatos de arquivo baseados em XML para Excel, PowerPoint e Word (como .xlsx, .pptx e .docx). Os documentos nesses formatos consistem em arquivos XML (também chamados de partes XML) que são organizados em pastas em um arquivo ZIP. A maioria das partes XML são partes internas que ajudam a definir a estrutura e o estado do documento. No entanto, os documentos também podem conter partes XML personalizadas, que você pode usar para armazenar dados XML arbitrários nos documentos.

Os formatos de arquivo XML permitem que os aplicativos trabalhem com documentos de maneiras que não são possíveis com os formatos de arquivo binário mais antigos (como .xls, .ppt e .doc). Qualquer aplicativo que possa ler arquivos ZIP pode examinar e modificar o conteúdo dos documentos, mesmo que o Microsoft Office não esteja instalado.

Para obter mais informações sobre a estrutura do Open XML e partes XML personalizadas, consulte os seguintes artigos:

Observação

Excel, Word e PowerPoint também permitem que você use partes XML personalizadas em documentos que são salvos nos formatos de arquivo binário. No entanto, se um documento for salvo em um formato binário, você não poderá adicionar ou modificar partes XML personalizadas sem iniciar o aplicativo do Microsoft Office.

Criar e modificar partes XML personalizadas

Você pode criar ou modificar partes XML personalizadas quando o documento estiver aberto no aplicativo do Office ou quando o documento estiver fechado, mesmo que o Microsoft Office não esteja instalado.

Modificar partes XML enquanto o aplicativo do Office está em execução

Você pode trabalhar com partes XML personalizadas usando uma personalização em nível de documento ou um suplemento VSTO. Se você estiver usando uma personalização em nível de documento, normalmente trabalhará com partes XML personalizadas que estão no documento personalizado. Se você estiver usando um suplemento VSTO, poderá criar ou modificar partes XML personalizadas em qualquer documento aberto no aplicativo.

Para criar uma parte XML personalizada usando o CustomXMLParts Visual Studio, adicione um novo CustomXMLPart à coleção no documento. Para Mais informações, consulte os seguintes tópicos:

Modificar partes XML sem iniciar o aplicativo do Office

Você pode adicionar ou modificar uma parte XML personalizada sem iniciar o Excel, PowerPoint ou Word. Isso é útil se você quiser trabalhar com dados XML em um documento em um computador que não tenha aplicativos do Microsoft Office instalados, como um servidor.

Para adicionar uma parte XML personalizada sem iniciar o Microsoft Office, use classes no SDK do Open XML. Essas classes são projetadas para fornecer acesso ao conteúdo Open XML que é específico para documentos do Office. Por exemplo, para adicionar uma parte XML personalizada a uma pasta de trabalho do Excel, use o AddNewPart método de um WorkbookPart objeto. Para obter mais informações, consulte Open XML SDK.

Vincular partes XML personalizadas a controles de conteúdo do Word

Você pode vincular controles de conteúdo em uma solução do Word a elementos em uma parte XML personalizada. Quando um controle de conteúdo é vinculado a uma parte XML personalizada, os dados na parte XML personalizada são exibidos na interface do usuário (UI) do controle de conteúdo. Se um usuário editar texto no controle, o elemento XML correspondente será atualizado automaticamente. Da mesma forma, se os valores de elemento nas partes XML personalizadas forem alterados, os controles de conteúdo vinculados aos elementos XML exibirão os novos dados. Para obter mais informações, consulte Controles de conteúdo.

Conteúdo relacionado