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

Você pode marcar um item de dados armazenados em cache no documento, para que fique disponível off-line. Isso também torna possível para os dados do documento para 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 2007 e Excel 2010; Word 2007 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 seja armazenada em cache quando o item de dados é declarado em seu código, ou, se você estiver usando um DataSet, definindo uma propriedade Propriedades janela. Se você estiver em cache um item de dados que não é um DataSet ou DataTable, certifique-se de que ela atenda aos critérios para que sejam armazenados em cache no documento. For more information, see Cache de dados.

ObservaçãoObservação

DataSets criados usando o Visual Basic que são marcadas como Cached e WithEvents (incluindo datasets arrastados da Fontes de dados janela ou caixa de ferramentas que têm o CacheInDocument propriedade definida como True) ter um sublinhado prefixado seus nomes no cache. Por exemplo, se você cria um dataset e nomeie-os clientes, o CachedDataItem nome será _Customers no cache. Quando você usa ServerDocument para acessar este item em cache, você deve especificar o _Customers em vez de clientes.

Dados em cache no documento usando código

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

  2. Aplicar o CachedAttribute atributo para o membro para marcar o item de dados sejam armazenados no cache de dados. do documento O exemplo a seguir se aplica a este 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. Adicione código para criar uma instância de um item de dados e, se aplicável, carregá-lo do banco de dados.

    O item de dados é carregado somente quando ele é criado pela primeira vez; daí em diante, o cache permaneça com o documento e você deve escrever outro código para atualizá-lo.

Armazenar em cache de um conjunto de dados no documento usando a janela de propriedades

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

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

  3. No Propriedades janela, defina a CacheInDocument propriedade para True.

    For more information, see Propriedades em projetos do Office.

  4. No Propriedades janela, defina a modificadores propriedade para pública (por padrão é interno).

Consulte também

Tarefas

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

Como: Cache de dados em um documento protegido por senha

Conceitos

Cache de dados

Acesso a dados em documentos no servidor

Outros recursos

Salvando dados

Concurrency Control in ADO.NET