Como: Armazenar em cache dados para uso off-line ou em um servidor

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 documento Versão do Microsoft Office Microsoft Office Sistema de 2007 Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode marcar um item de dados para ser armazenada em cache no documento, para que fique disponível off-line.Isso também torna possível para os dados no documento para ser manipulado por outro código quando o documento é armazenado em um servidor.

Você pode marcar um item de dados para ser armazenada em cache quando o item de dados é declarado no seu código, ou, se você estiver usando um DataSet, por Configuração uma propriedade na janela Propriedades.Se o cache de um item de dados que não seja um DataSet ou DataTable, certifique-se de que atenderem aos critérios para sendo em cache no documento.For more information, see Cache de dados.

Observação:

Conjuntos de dados criados com Visual Basic que são marcadas como Cached e WithEvents (incluindo datasets são arrastados de Fontes de dados janela ou Caixa de Ferramentas que têm a propriedade de CacheInDocument definido como Verdadeiro) têm um sublinhado o prefixo para seus nomes no cache.Por exemplo, se você Criar um dataset e nomeie-os clientes, o nome de CachedDataItem será _Customers no cache.Quando você usa ServerDocument para acessar este item em cache, você deve especificar _Customers em vez de clientes.

A dados de cache em documento usando código

1. Declare um campo público ou propriedade para os dados de item como membro de uma classe de item de host no seu projeto, como o t ThisDocumenclasse no Word projeto ou a classe de ThisWorkbook em um projeto do Excel.

2. Aplicar o atributo CachedAttribute para o membro para marcar o item de dados sejam armazenados em cache de dados do documento.O exemplo seguinte aplica esse atributo para uma declaração de campo para um DataSet.

   <Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
   Public employeesDataSet As DataSet
   

   [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
   public DataSet employeesDataSet;
   

3. Adicionar código para criar uma instância do item de dados e, se aplicável, carregá-lo do banco de dados.

   O item de dados só será carregado quando ela é criada pela Primeiro vez; Daí em diante, o cache permanece com o documento e você deve Gravar outro código para Atualizar-lo.

Em cache um dataset no documento usando Janela Propriedades

1. Adicionar o dataset para o projeto usando ferramentas do designer do Visual Studio, por exemplo, adicionando uma fonte de dados ao seu projeto usando a janela de fontes de dados.

2. Criar uma instância do dataset se você não já tiver um e Selecionar a instância no designer.

3. Na janela Propriedades , defina o CacheInDocument propriedade para Verdadeiro de .

   For more information, see Propriedades no Visual Studio Tools para projetos do Office.

4. Na janela Propriedades , defina Modificadores de propriedade de a Público (por padrão é Interno).

Consulte também

Tarefas

Como: Armazenar em cache programaticamente uma Origem de dados em um documento do Office

Como: Parar programaticamente o cache de uma Origem de dados

Como: Dados de cache em um documento protegida por senha

Conceitos

Cache de dados

Acessando dados em documentos no servidor

Outros recursos

Salvando dados

Controle de Simultaneidade no ADO.NET