Compartilhar via

Armazenar dados em cache para uso offline ou em um servidor

  • Artigo

Você pode marcar um item de dados para armazenamento em cache no documento, para que ele fique disponível offline. Isso também possibilita que os dados no documento sejam manipulados por outro código quando o documento é armazenado em um servidor.

Aplicável a: as informações neste tópico são aplicáveis aos projetos no nível de documento para Excel e Word. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Você pode marcar um item de dados para armazenamento em cache quando o item de dados for declarado em seu código ou, se estiver usando um DataSet, definindo uma propriedade na janela Propriedades. Se você estiver armazenando em cache um item de dados que não seja um DataSet ou DataTable, certifique-se de que ele atenda aos critérios para ser armazenado em cache no documento. Para obter mais informações, confira Armazenar dados em cache.

Observação

Os conjuntos de dados criados usando o Visual Basic marcados como Armazenado em cache e WithEvents (incluindo conjuntos de dados arrastados da janela Fontes de Dados ou Caixa de ferramentas que têm a propriedade CacheInDocument definida como Verdadeiro) têm um sublinhado prefixado a seus nomes no cache. Por exemplo, se você criar um conjunto de dados e nomeá-lo como Clientes, o nome será CachedDataItem _Customers no cache. Ao usar ServerDocument para acessar esse item armazenado em cache, você deve especificar _Customers em vez de Clientes.

Para armazenar dados em cache no documento usando código

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

  2. Aplique o atributo CachedAttribute ao membro para marcar o item de dados para armazenamento no cache de dados do documento. O exemplo a seguir aplica esse atributo a uma declaração de campo para um DataSet.

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

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

    O item de dados só é carregado quando é criado pela primeira vez. Depois disso, o cache permanece com o documento e você deve escrever outro código para atualizá-lo.

Para armazenar em cache um conjunto de dados no documento usando a janela Propriedades

  1. Adicione o conjunto de dados ao projeto usando ferramentas no designer do Visual Studio, por exemplo, adicionando uma fonte de dados ao seu projeto usando a janela Fontes de Dados.

  2. Se ainda não tiver uma instância do conjunto de dados, crie uma e selecione a instância no designer.

  3. Na janela Propriedades, defina a propriedade CacheInDocument como True.

    Para obter mais informações, consulte Propriedades em projetos do Office.

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

Conteúdo relacionado