Freigeben über

Zwischenspeichern von Daten für die Offlineverwendung oder auf einem Server

  • Artikel

Sie können ein Datenelement markieren, das im Dokument zwischengespeichert werden soll, damit es offline verfügbar ist. Dadurch können die Daten im Dokument auch von einem anderen Code bearbeitet werden, wenn das Dokument auf einem Server gespeichert wird.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Excel und Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

Sie können ein Datenelement markieren, das zwischengespeichert werden soll, wenn das Datenelement in Ihrem Code deklariert wird, oder wenn Sie ein DataSetDatenelement verwenden, indem Sie eine Eigenschaft im Eigenschaftenfenster festlegen. Wenn Sie ein Datenelement zwischenspeichern, das kein DataSetDataTableOder ist, stellen Sie sicher, dass es die Kriterien für die Zwischenspeicherung im Dokument erfüllt. Weitere Informationen finden Sie unter Cachedaten.

Hinweis

Datasets, die mit Visual Basic erstellt wurden, die als zwischengespeichert und WithEvents (einschließlich Datasets, die aus dem Fenster "Datenquellen" oder "Toolbox" gezogen werden, die die CacheInDocument-Eigenschaft auf "True" festgelegt haben), weisen einen Unterstrich mit dem Präfix ihrer Namen im Cache auf. Wenn Sie beispielsweise ein Dataset erstellen und kundennamen, wird der CachedDataItem Name im Cache _Customers. Wenn Sie für den Zugriff auf dieses zwischengespeicherte Element verwendenServerDocument, müssen Sie anstelle von Kunden _Customers angeben.

So speichern Sie Daten im Dokument mithilfe von Code zwischen

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

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

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

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

    Das Datenelement wird nur geladen, wenn es zum ersten Mal erstellt wird. Anschließend bleibt der Cache beim Dokument erhalten, und Sie müssen anderen Code schreiben, um ihn zu aktualisieren.

So speichern Sie ein Dataset im Dokument mithilfe der Eigenschaftenfenster

  1. Fügen Sie das Dataset dem Projekt mithilfe von Tools im Visual Studio-Designer hinzu, z. B. durch Hinzufügen einer Datenquelle zu Ihrem Projekt mithilfe des Fensters "Datenquellen ".

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

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

    Weitere Informationen finden Sie unter "Eigenschaften" in Office-Projekten.

  4. Legen Sie im Eigenschaftenfenster die Eigenschaft "Modifizierer" auf "Öffentlich" fest (standardmäßig ist sie intern).

Zugehöriger Inhalt