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

Artigo
08/08/2011

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çã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.

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

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.
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;
```
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

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.
Crie uma instância do dataset, se você ainda não tiver um e selecione a instância no designer.
No Propriedades janela, defina a CacheInDocument propriedade para True.

For more information, see Propriedades em projetos do Office.
No Propriedades janela, defina a modificadores propriedade para pública (por padrão é interno).

Consulte também

Compartilhar via

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

Dados em cache no documento usando código

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

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais