Cómo: Almacenar en memoria caché un origen de datos de un documento de Office mediante programación

Artículo
08/10/2011

Se puede agregar mediante programación un objeto de datos a la caché de datos de un documento llamando al método StartCaching de un elemento de host, como Document, Workbook o Worksheet. Quite un objeto de datos de la memoria caché de datos llamando al método StopCaching de un elemento host.

Los métodos StartCaching y StopCaching son privados pero aparecen en IntelliSense.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento para las siguientes aplicaciones: Excel 2007 y Excel 2010; Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Cuando se utiliza el método StartCaching para agregar un objeto de datos a la caché de datos, no es necesario declarar el objeto de datos con el atributo CachedAttribute. Sin embargo, el objeto de datos debe cumplir ciertos requisitos para poder agregarse a la caché de datos. Para obtener más información, vea Almacenar datos en caché.

Para almacenar en memoria caché un objeto de datos mediante programación

Declare el objeto de datos en el nivel de clase, no dentro de un método. Este ejemplo supone que está declarando un objeto DataSet denominado dataSet1 que desea almacenar en memoria caché mediante programación.
```
Public dataSet1 As DataSet
```
```
public DataSet dataSet1;
```

Cree una instancia del objeto de datos y, a continuación, llame al método StartCaching de la instancia del documento o la hoja de cálculo y pase el nombre del objeto de datos.

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 dejar de almacenar en memoria caché un objeto de datos

Llame al método StopCaching de la instancia del documento o la hoja de cálculo y pase el nombre del objeto de datos. En este ejemplo, se supone que tiene un DataSet denominado dataSet1 en el que desea detener el almacenamiento en caché.
```
If (Me.IsCached("dataSet1")) Then
    Me.StopCaching("dataSet1")
End If
```
```
if (this.IsCached("dataSet1"))
{
    this.StopCaching("dataSet1");
}
```
Nota

No llame a StopCaching desde el controlador del evento Shutdown de un documento o una hoja de cálculo. Para cuando se inicie el evento Shutdown, será demasiado tarde para modificar la caché de datos. Para obtener más información sobre el evento Shutdown, vea Eventos de los proyectos de Office.

Vea también

Cómo: Almacenar en memoria caché un origen de datos de un documento de Office mediante programación

Para almacenar en memoria caché un objeto de datos mediante programación

Para dejar de almacenar en memoria caché un objeto de datos

Vea también

Tareas

Conceptos

Otros recursos

Recursos adicionales