Freigeben über


Gewusst wie: Zwischenspeichern von Daten zur Offlineverwendung oder zur Verwendung auf einem Server

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Dokumentebene

Microsoft Office-Version

  • 2007 Microsoft Office System

  • Microsoft Office 2003

Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Sie können in einem Dokument ein Datenelement für die Zwischenspeicherung kennzeichnen, um es offline verfügbar zu machen. Dabei können die in dem Dokument enthaltenen Daten durch anderen Code geändert werden, falls das Dokument auf einem Server gespeichert wird.

Sie können ein Datenelement entweder bei der Deklaration für die Zwischenspeicherung kennzeichnen oder – wenn Sie DataSet verwenden – im Eigenschaftenfenster die Eigenschaft entsprechend festlegen. Wenn Sie ein Datenelement zwischenspeichern, dass weder ein DataSet noch eine DataTable ist, müssen Sie sicherstellen, dass das Datenelement die Bedingungen für eine Zwischenspeicherung im Dokument erfüllt. Weitere Informationen hierzu finden Sie unter Zwischenspeichern von Daten.

Hinweis:

Datasets, die unter Verwendung von Visual Basic erstellt wurden und als Cached und WithEvents gekennzeichnet sind (einschließlich Datasets, die aus dem Datenquellenfenster oder aus der Toolbox gezogen wurden und deren CacheInDocument-Eigenschaft auf True festgelegt wurde), werden mit einem dem Namen vorangestellten Unterstrich im Cache gespeichert. Wenn Sie beispielsweise ein Dataset mit dem Namen Kunden erstellen, lautet der CachedDataItem-Name im Cache _Kunden. Wenn Sie für den Zugriff auf dieses zwischengespeicherte Element ServerDocument verwenden, müssen Sie _Kunden anstelle von Kunden angeben.

So können Sie Daten im Dokument unter Verwendung von Code zwischenspeichern

  1. Deklarieren Sie ein öffentliches Feld oder eine öffentliche Eigenschaft für das Datenelement als Member einer Hostelementklasse im Projekt, z. B. als ThisDocument-Klasse in einem Word-Projekt oder als ThisWorkbook-Klasse in einem Excel-Projekt.

  2. Wenden Sie das CachedAttribute-Attribut auf den Member an, um das Datenelement für das Speichern im Datencache des Dokuments zu markieren. Im folgenden Beispiel wird dieses Attribut auf eine Felddeklaration für ein DataSet angewendet.

    <Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
    Public employeesDataSet As DataSet
    
    [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
    public DataSet employeesDataSet;
    
  3. Fügen Sie Code hinzu, um eine Instanz des Datenelements zu erstellen und es gegebenenfalls aus der Datenbank zu laden.

    Das Datenelement wird nur bei der Erstellung geladen. Der Cache und damit auch das Dokument bleiben erhalten, und Sie müssen weiteren Code schreiben, um den Cache zu aktualisieren.

So können Sie ein DataSet im Dokument unter Verwendung des Eigenschaftenfensters zwischenspeichern

  1. Fügen Sie in Visual Studio Designer dem Projekt mittels der entsprechenden Tools das DataSet hinzu. Eine Möglichkeit besteht darin, dem Projekt unter Verwendung des Datenquellenfensters eine Datenquelle hinzuzufügen.

  2. Falls noch keine Instanz des Datasets existiert, erstellen Sie eine Instanz, und wählen Sie im Designer die Instanz aus.

  3. Legen Sie im Eigenschaftenfenster die Eigenschaft CacheInDocument auf True fest.

    Weitere Informationen finden Sie unter Eigenschaften in Visual Studio Tools for Office-Projekte.

  4. Legen Sie im Eigenschaftenfenster die Modifiers-Eigenschaft auf Public fest (der Standardwert ist Internal).

Siehe auch

Aufgaben

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

Gewusst wie: Programmgesteuertes Beenden des Zwischenspeicherns einer Datenquelle

Gewusst wie: Zwischenspeichern von Daten in einem kennwortgeschützten Dokument

Konzepte

Zwischenspeichern von Daten

Zugreifen auf Daten in Dokumenten auf dem Server

Weitere Ressourcen

Speichern von Daten

Parallelitätssteuerung in ADO.NET