Procedura: memorizzare nella cache a livello di codice un'origine dati di un documento di Office

Articolo
08/11/2011

È possibile aggiungere un oggetto dati a livello di codice alla cache di dati in un documento chiamando il metodo StartCaching di un elemento host, come Document, Workbook o Worksheet. Rimuovere un oggetto dati dalla cache di dati chiamando il metodo StopCaching di un elemento host.

Il metodo StartCaching e il metodo StopCaching sono entrambi privati, ma vengono visualizzati in IntelliSense.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2007, Excel 2010, Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Quando si utilizza il metodo StartCaching per aggiungere un oggetto dati alla cache di dati, non è necessario dichiarare l'oggetto dati con l'attributo CachedAttribute. Tuttavia, l'oggetto dati deve soddisfare alcuni requisiti per poter essere aggiunto alla cache di dati. Per ulteriori informazioni, vedere la classe Memorizzazione di dati nella cache.

Per memorizzare un oggetto dati nella cache a livello di codice

Dichiarare l'oggetto dati come livello di classe, non all'interno di un metodo. In questo esempio si presume che venga dichiarato un oggetto DataSet denominato dataSet1 che si intende memorizzare nella cache a livello di codice.
```
Public dataSet1 As DataSet
```
```
public DataSet dataSet1;
```

Creare l'istanza dell'oggetto dati, quindi chiamare il metodo StartCaching dell'istanza di documento o foglio di lavoro e passare il nome dell'oggetto dati.

dataSet1 = New DataSet()

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

dataSet1 = new DataSet();

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

Per interrompere la memorizzazione di un oggetto dati nella cache

Chiamare il metodo StopCaching dell'istanza di documento o foglio di lavoro e passare il nome dell'oggetto dati. In questo esempio si presume che sia disponibile un DataSet denominato dataSet1 di cui si intende interrompere la memorizzazione nella cache.
```
If (Me.IsCached("dataSet1")) Then
    Me.StopCaching("dataSet1")
End If
```
```
if (this.IsCached("dataSet1"))
{
    this.StopCaching("dataSet1");
}
```
Nota

Non chiamare StopCaching gestore eventi per l'evento Shutdown di un documento o foglio di lavoro. Nel momento in cui viene generato l'evento Shutdown, non è più possibile modificare la cache dei dati. Per ulteriori informazioni sull'evento Shutdown, vedere Eventi nei progetti di Office.

Vedere anche

Condividi tramite

Procedura: memorizzare nella cache a livello di codice un'origine dati di un documento di Office

Per memorizzare un oggetto dati nella cache a livello di codice

Per interrompere la memorizzazione di un oggetto dati nella cache

Vedere anche

Attività

Concetti

Altre risorse

Risorse aggiuntive