Visão geral de partes XML personalizada

Artigo
08/08/2011

Você pode incorporar dados XML em documentos para alguns aplicativos de Microsoft Office. Ao incorporar dados XML em um documento, os dados são denominados um parte XML personalizada.

Você pode criar e modificar partes XML em um documento usando uma solução de nível de aplicativo ou no nível do documento em Visual Studio. Você não precisará iniciar o aplicativo Microsoft Office para criar e modificar partes do XML personalizados.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para os seguintes aplicativos: Excel 2007 e Excel 2010; PowerPoint 2007 e PowerPoint 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 também permite objetos de dados do cache no nível do documento personalizações. Esse recurso é diferente de partes XML personalizadas, embora haja algumas semelhanças. For more information, see Dados armazenados em cache no nível do documento personalizações.

Noções básicas sobre partes do XML personalizado

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

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

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

Observação
PowerPoint, Word e Excel também permitem usar partes XML em documentos são salvos nos formatos de arquivo binário. No entanto, se um documento for salvo em um formato binário, não é possível adicionar ou modificar partes XML sem iniciar o aplicativo Microsoft Office.

Criar e modificar partes do XML personalizado

Você pode criar ou modificar partes XML quando o documento está aberto no aplicativo do Office, ou quando o documento é fechado — mesmo se Microsoft Office não está instalado.

A modificação de partes XML durante a execução do aplicativo do Office

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

Para criar um componente XML personalizado usando o Visual Studio, adicione um novo CustomXMLPart para o CustomXMLParts a coleção do documento. For more information, see the following topics:

A modificação de partes XML sem iniciar o aplicativo do Office

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

Para adicionar um componente XML personalizado sem iniciar o Microsoft Office, há duas opções:

Use classes no SDK de formato XML aberto. Essas classes são projetadas para fornecer acesso ao conteúdo XML aberto que é específico para documentos do Office. Por exemplo, para adicionar um componente XML personalizado para uma pasta de trabalho do Excel, use o AddNewPart <T> o método de um WorkbookPart objeto. Para obter mais informações, consulte como: Inserir o XML para um pacote XML aberto do Office personalizada usando a API de XML aberta.
Use as classes de System.IO.Packaging namespace. As classes neste namespace fornecem uma maneira de ler e modificar o conteúdo de qualquer arquivo XML abertos, incluindo documentos do Office. As classes no SDK de formato XML aberto baseiam-se dessas classes. Você pode usar essas classes em qualquer aplicativo que usa o.NET Framework 3.0 ou posterior, como, por exemplo, um aplicativo de console, um aplicativo Windows Forms ou um aplicativo de Windows Presentation Foundation (WPF). For more information, see Como: Adicionar partes XML personalizado para documentos sem iniciar o Microsoft Office.

Partes XML vinculação personalizada para controles de conteúdo do Word

Você pode vincular controles de conteúdo em uma solução do Word para os elementos em uma parte XML personalizada. Quando um controle de conteúdo está 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 edita o texto no controle, o elemento XML correspondente é atualizado automaticamente. Da mesma forma, se os valores de elemento em partes XML personalizadas forem alterados, os controles de conteúdo são vinculados aos elementos XML exibem novos dados. For more information, see Controles de conteúdo.