Dados armazenados em cache em personalizações em nível de documento

Um objetivo principal das personalizações em nível de documento é separar os dados da exibição em documentos do Office. Dados referem-se às informações armazenadas no documento, incluindo números e texto. View refere-se à interface do usuário e ao modelo de objeto do Microsoft Office Word e do Microsoft Office Excel.

O Visual Studio separa os dados do modo de exibição em personalizações em nível de documento, permitindo que os dados sejam incorporados como uma ilha de dados, também chamada de cache de dados. Você pode ler ou modificar os dados diretamente sem iniciar o Word ou o Excel. Isso é útil quando você precisa modificar dados em documentos em um servidor que não tenha o Microsoft Office instalado. Word e Excel são destinados ao uso em ambientes de clientes; eles não são projetados para serem executados em um servidor.

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.

Para obter mais informações sobre personalizações em nível de documento, consulte Visão geral do desenvolvimento de soluções do Office (VSTO) e Arquitetura de personalizações em nível de documento.

Compreender o modelo de programação de dados armazenados em cache

A ilha de dados pode conter qualquer objeto em sua solução que atenda a determinados requisitos. Esses objetos incluem DataSet objetos, DataTable objetos e qualquer outro objeto que possa ser serializado XmlSerializer pela classe. Para obter mais informações, consulte Dados de cache.

Para fornecer a exibição dos dados armazenados em cache, você pode vincular controles do Windows Forms e controles de host no documento a objetos na ilha de dados. A vinculação de dados entre a ilha de dados e os controles vinculados a dados mantém os dois sincronizados. Você também pode adicionar código de validação aos dados que são independentes dos controles. Para obter mais informações, consulte Vincular dados a controles em soluções do Office.

Os controles de host são versões estendidas de objetos nativos nos modelos de objeto do Excel e do Word. Ao contrário dos objetos nativos, os controles de host podem ser vinculados diretamente a objetos de dados gerenciados. Para obter mais informações, consulte Visão geral de itens de host e controles de host e Visão geral de controles do Windows Forms em documentos do Office.

Acessar dados armazenados em cache no servidor

Para acessar dados armazenados em cache em um documento, você pode usar a ServerDocument classe. Essa classe faz parte do Visual Studio Tools for Office runtime e pode ser usada em um servidor sem executar o Excel ou o Word. Quando o usuário abre o documento depois de modificar os dados armazenados em cache, todos os controles vinculados aos dados são sincronizados automaticamente com as alterações e os dados atualizados são apresentados ao usuário. Para obter mais informações, consulte Acessar dados em documentos no servidor.

O Excel e o Word não são necessários para gravar nos dados no servidor, apenas para exibi-los no cliente. O Excel e o Word nem precisam ser instalados no servidor. Isso fornece escalabilidade aprimorada e a capacidade de executar o processamento em lote rápido de documentos que contêm ilhas de dados.

Cache de dados para uso offline

O armazenamento de dados na ilha de dados permite cenários offline. Quando um usuário abre um documento pela primeira vez ou solicita o documento do servidor, a ilha de dados é preenchida com os dados mais recentes. A ilha de dados é armazenada em cache no documento e, em seguida, fica disponível offline. O usuário (e seu código) pode manipular os dados, mesmo que nenhuma conexão em tempo real esteja disponível. Quando o usuário se reconecta, as alterações nos dados podem ser propagadas de volta para uma fonte de dados do servidor.

Dados armazenados em cache e partes XML personalizadas comparadas

Partes XML personalizadas foram introduzidas no 2007 Microsoft Office System como uma maneira de armazenar partes arbitrárias de XML em um documento. Embora as partes XML personalizadas sejam úteis em muitos dos mesmos cenários que o cache de dados, há algumas diferenças entre a ilha de dados e as partes XML personalizadas. Para obter mais informações sobre partes XML personalizadas, consulte Visão geral de partes XML personalizadas.

A tabela a seguir lista algumas das diferenças e semelhanças.

Pergunta / Característica	Cache de dados	Partes XML personalizadas
Quais aplicativos do Office podem usá-los?	Personalizações em nível de documento para os seguintes aplicativos: -Distinguir-se -Palavra	Soluções em nível de documento e de aplicativo para os seguintes aplicativos: -Distinguir-se - PowerPoint -Palavra
Que tipos de dados você pode armazenar?	Qualquer objeto público em seu assembly de personalização que atenda a determinados requisitos. Para obter mais informações, consulte Dados de cache.	Quaisquer dados XML.
Você pode acessar os dados sem iniciar aplicativos do Microsoft Office?	Sim, usando a ServerDocument classe fornecida pelo Visual Studio Tools for Office runtime .	Sim, usando classes no System.IO.Packaging namespace ou usando o Open XML Format SDK.

Conteúdo relacionado

• Dados em soluções do Office
• Arquitetura de soluções do Office no Visual Studio