Compartilhar via


Como: os dados em Cache para uso off-line ou em um servidor

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

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento para os seguintes aplicativos: Excel 2013 e Excel 2010; Word 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Você pode marcar um item de dados a ser armazenado em cache quando o item de dados é declarado em seu código, ou, se você estiver usando DataSet, definindo uma propriedade na janela de Propriedades .Se você estiver fazendo cache um item de dados que não é DataSet ou DataTable, certifique-se de que localize os critérios para ser armazenado em cache no documento.Para obter mais informações, consulte Cache de dados.

ObservaçãoObservação

Datasets criados usando o Visual Basic que estão marcados como Cached e WithEvents (incluindo dataset que são arrastados da janela ou de Caixa de Ferramentas de Fontes de Dados que têm a propriedade de CacheInDocument definida como True) para ter um sublinhado prefixado com seus nomes no cache.Por exemplo, se você criar um dataset e o nomeia clientes, o nome de CachedDataItem será _Customers no cache.Quando você usa ServerDocument para acessar esse item em cache, você deve especificar _Customers em vez de clientes.

Para armazenar em cache os dados no documento usando código

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

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

    <Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
    Public employeesDataSet As DataSet
    
    [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
    public DataSet employeesDataSet;
    
  3. Adicione código para criar uma instância de item de dados e, se aplicável, para carregá-lo de banco de dados.

    O item de dados é carregado somente quando é projetado principalmente; depois de isso, o cache com o documento e você deve escrever o outro código para atualizá-lo.

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

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

  2. Crie uma instância do dataset se você não tiver um, e selecione a instância no designer.

  3. Em a janela de Propriedades , defina a propriedade de CacheInDocument a True.

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

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

Consulte também

Tarefas

Como: armazenar em Cache programaticamente uma fonte de dados em um documento do Office

Como: dados do Cache em um documento protegido por senha

Conceitos

Cache de dados

Acesso a dados em documentos no servidor

Salvar dados