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

Artigo
08/08/2011

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

O StartCaching método e a StopCaching método são ambas privadas, mas eles aparecem 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 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.

Quando você usa o StartCaching método para adicionar um objeto de dados no cache de dados, o objeto de dados não precisa ser declarada com o CachedAttribute atributo. No entanto, o objeto de dados deve atender a certos requisitos a ser adicionado ao cache de dados. For more information, see Cache de dados.

Para um objeto de dados em cache programaticamente

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

Instanciar o objeto de dados e, em seguida, chame o StartCaching o método de instância de documento ou planilha e passar o 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 a um objeto de dados de cache

Chamar o StopCaching o método de instância de documento ou planilha e passar o nome do objeto de dados. Este exemplo pressupõe que você tenha um DataSet chamado dataSet1 que você deseja interromper o armazenamento em cache.

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

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

Observação
Não chame StopCaching do manipulador de eventos para o Shutdown o evento de um documento ou planilha. No momento o Shutdown evento é gerado, é tarde demais para modificar o cache de dados. For more information about the Shutdown event, see Eventos em projetos do Office.

Consulte também

Compartilhar via

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

Para um objeto de dados em cache programaticamente

Para parar a um objeto de dados de cache

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais