Freigeben über

Zwischenspeichern von Daten zur Verwendung offline oder auf einem Server

  • Artikel

Sie können ein Datenelement zum Zwischenspeichern im Dokument markieren, sodass es offline verfügbar ist. Dadurch können die Daten im Dokument auch von anderem Code manipuliert werden, wenn das Dokument auf einem Server gespeichert ist.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Excel und Word. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Sie können ein Datenelement zum Zwischenspeichern markieren, wenn das Datenelement in Ihrem Code deklariert wird, oder, wenn Sie ein DataSet verwenden, indem Sie eine Eigenschaft im Fenster Eigenschaften festlegen. Wenn Sie ein Datenelement zwischenspeichern wollen, das kein DataSet oder DataTable ist, stellen Sie sicher, dass es die Kriterien für das Zwischenspeichern im Dokument erfüllt. Weitere Informationen finden Sie unter Cache-Daten.

Hinweis

Mit Visual Basic erstellte Datasets, die als Cached und WithEvents gekennzeichnet sind (einschließlich Datasets, die aus dem Fenster Datenquellen oder Toolbox gezogen werden und bei denen die Eigenschaft CacheInDocument auf Wahr festgelegt wurde), haben im Cache einen Unterstrich vor ihrem Namen. Wenn Sie zum Beispiel ein Dataset erstellen und es Kunden nennen, lautet der CachedDataItem Name im Cache _Kunden. Wenn Sie ServerDocument verwenden, um auf dieses gecachte Element zuzugreifen, müssen Sie _Kunden anstelle von Kunden angeben.

So speichern Sie Daten im Dokument mit Hilfe von Code im Cache

  1. Deklarieren Sie ein öffentliches Feld oder eine Eigenschaft für das Datenelement als Mitglied einer Host-Elementklasse in Ihrem Projekt, sodass die ThisDocument-Klasse in einem Word-Projekt oder die ThisWorkbook-Klasse in einem Excel-Projekt.

  2. Wenden Sie das Attribut CachedAttribute auf das Mitglied an, um das Datenelement zu markieren, das im Daten-Cache des Dokuments gespeichert werden soll. Im folgenden Beispiel wird dieses Attribut auf eine Felddeklaration für ein DataSet angewendet.

    [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
public DataSet employeesDataSet;

  3. Fügen Sie Code hinzu, um eine Instanz des Datenelements zu erstellen und es ggf. aus der Datenbank zu laden.

    Das Datenelement wird nur geladen, wenn es zum ersten Mal erstellt wird. Danach verbleibt der Cache im Dokument und Sie müssen weiteren Code schreiben, um ihn zu aktualisieren.

So speichern Sie ein Dataset im Dokument mit Hilfe des Fensters Eigenschaften zwischen

  1. Fügen Sie das Dataset mit Hilfe der Tools im Visual Studio Designer zum Projekt hinzu, z. B. durch Hinzufügen einer Datenquelle zu Ihrem Projekt über das Fenster Datenquellen.

  2. Erstellen Sie eine Instanz des Datasets, wenn Sie noch keine haben, und wählen Sie die Instanz im Designer aus.

  3. Legen Sie im Fenster Eigenschaften die Eigenschaft CacheInDocument auf Wahr fest.

    Weitere Informationen finden Sie unter Eigenschaften in Office-Projekten.

  4. Legen Sie im Fenster Eigenschaften die Eigenschaft Modifikatoren auf Öffentlich fest (standardmäßig ist sie Intern).

Zugehöriger Inhalt