Gewusst wie: Zwischenspeichern von Daten zur Offlineverwendung oder zur Verwendung auf einem Server
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.
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.
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.
Tipp
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 ServerDocument für den Zugriff auf dieses zwischengespeicherte Element verwenden, müssen Sie "_Kunden" anstelle von "Kunden" angeben.
So können Sie Daten im Dokument unter Verwendung von Code zwischenspeichern
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.
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;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
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.
Falls noch keine Instanz des Datasets existiert, erstellen Sie eine Instanz, und wählen Sie im Designer die Instanz aus.
Legen Sie im Eigenschaftenfenster die Eigenschaft CacheInDocument auf True fest.
Weitere Informationen finden Sie unter Eigenschaften in Office-Projekten.
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: Zwischenspeichern von Daten in einem kennwortgeschützten Dokument
Konzepte
Zugreifen auf Daten in Dokumenten auf dem Server