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

Artigo
02/25/2013

Você pode adicionar programaticamente um objeto de dados para o cache de dados em um documento chamando o método de StartCaching de um item host, como Document, Workbook, ou Worksheet.Remover um objeto de dados de cache de dados chamando o método de StopCaching de um item host.

O método de StartCaching e o método de StopCaching forem ambos particulares, mas aparece no IntelliSense.

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.

Quando você usa o método de StartCaching para adicionar um objeto de dados para o cache de dados, o objeto de dados não precisa ser declarada com o atributo de CachedAttribute .Em o entanto, o objeto de dados deve atender a certos requisitos ser adicionado ao cache de dados.Para obter mais informações, consulte Cache de dados.

para armazenar em cache programaticamente um objeto de dados

Declare o objeto de dados no nível de classe, não dentro de um método.Este exemplo assume que você está declarando DataSet chamado dataSet1 que você deseja armazenar em cache programaticamente.
```
Public dataSet1 As DataSet
```
```
public DataSet dataSet1;
```

Instanciar o objeto de dados, e então chame o método de StartCaching de instância de documento ou a planilha e passar em nome do objeto de dados.

dataSet1 = New DataSet()

If Not (Me.IsCached("dataSet1")) Then
    Me.StartCaching("dataSet1")
End If

dataSet1 = new DataSet();

if (!this.IsCached("dataSet1"))
{
    this.StartCaching("dataSet1");
}

Para parar de cache um objeto de dados

Chame o método de StopCaching de instância de documento ou a planilha e passar em nome do objeto de dados.Este exemplo pressupõe que você tem DataSet chamado dataSet1 que você deseja parar de armazenar em cache.

If (Me.IsCached("dataSet1")) Then
    Me.StopCaching("dataSet1")
End If

if (this.IsCached("dataSet1"))
{
    this.StopCaching("dataSet1");
}

Observação
Não chamar StopCaching do manipulador de eventos para o evento de Shutdown de um documento ou uma planilha.Antes que o evento de Shutdown é gerado, é muito tarde alterar o cache de dados.Para obter mais informações sobre o evento Shutdown, consulte Eventos em projetos do Office.