Gewusst wie: Programmgesteuertes Zwischenspeichern von Datenquellen in einem Office-Dokument

Artikel
08/10/2011

Sie können dem Datencache in einem Dokument programmgesteuert ein Datenobjekt hinzufügen, indem Sie die StartCaching-Methode eines Hostelements aufrufen (also z. B. in einem Document, Workbook oder Worksheet). Entfernen Sie ein Datenobjekt aus dem Datencache, indem Sie die StopCaching-Methode eines Hostelements aufrufen.

Die StartCaching-Methode und die StopCaching-Methode sind private-Methoden, sie werden jedoch in IntelliSense angezeigt.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für die folgenden Anwendungen: Excel 2007 und Excel 2010, Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Wenn Sie die StartCaching-Methode für das Hinzufügen eines Datenobjekts zum Datencache verwenden, muss das Datenobjekt nicht mit dem CachedAttribute-Attribut deklariert werden. Das Datenobjekt muss jedoch bestimmte Anforderungen erfüllen, damit es dem Datencache hinzugefügt werden kann. Weitere Informationen hierzu finden Sie unter Zwischenspeichern von Daten.

So können Sie ein Datenobjekt programmgesteuert im Cache zwischenspeichern

Deklarieren Sie das Datenobjekt auf Klassenebene und nicht innerhalb einer Methode. In diesem Beispiel wird davon ausgegangen, dass Sie ein DataSet mit dem Namen dataSet1 deklarieren, das Sie programmgesteuert zwischenspeichern möchten.
```
Public dataSet1 As DataSet
```
```
public DataSet dataSet1;
```

Instanziieren Sie das Datenobjekt. Rufen Sie anschließend die StartCaching-Methode der Dokument- bzw. Arbeitsblattinstanz auf, und übergeben Sie den Namen des Datenobjekts.

dataSet1 = New DataSet()

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

dataSet1 = new DataSet();

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

So beenden Sie das Zwischenspeichern eines Datenobjekts

Rufen Sie die StopCaching-Methode der Dokument- oder der Arbeitsblattinstanz auf, und übergeben Sie den Namen des Datenobjekts. In diesem Beispiel wird davon ausgegangen, dass ein DataSet mit der Bezeichnung dataSet1 vorliegt, dessen Zwischenspeicherung Sie beenden möchten.
```
If (Me.IsCached("dataSet1")) Then
    Me.StopCaching("dataSet1")
End If
```
```
if (this.IsCached("dataSet1"))
{
    this.StopCaching("dataSet1");
}
```
Tipp

Rufen Sie StopCaching nicht im Ereignishandler für das Shutdown-Ereignis eines Dokuments oder eines Arbeitsblattes auf. Sobald das Shutdown-Ereignis ausgelöst wurde, kann der Datencache nicht mehr geändert werden. Weitere Informationen zum Shutdown-Ereignis finden Sie unter Ereignisse in Office-Projekten.

Siehe auch

Freigeben über

Gewusst wie: Programmgesteuertes Zwischenspeichern von Datenquellen in einem Office-Dokument

So können Sie ein Datenobjekt programmgesteuert im Cache zwischenspeichern

So beenden Sie das Zwischenspeichern eines Datenobjekts

Siehe auch

Aufgaben

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen