Procedura: memorizzare dati nella cache per l'utilizzo non in linea o su un server
Aggiornamento: novembre 2007
Si applica a |
|---|
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto
Versione Microsoft Office
Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione. |
È possibile contrassegnare un elemento dati per la memorizzazione nella cache del documento e quindi per il successivo utilizzo non in linea. In questo modo, si favorisce anche la modifica dei dati del documento mediante altro codice quando il documento è memorizzato su un server.
L'elemento dati può essere contrassegnato per la memorizzazione nella cache quando è dichiarato nel codice oppure, se si utilizza un oggetto DataSet, quando si imposta una proprietà nella finestra Proprietà. Se si memorizza nella cache un elemento dati che non è un oggetto DataSet o DataTable, assicurarsi che soddisfi i criteri necessari per la memorizzazione nella cache del documento. Per ulteriori informazioni, vedere la classe Memorizzazione di dati nella cache.
.gif "Nota") Nota: |
|---|
I nomi dei DataSet creati con Visual Basic che sono contrassegnati come Cached e WithEvents (compresi i DataSet trascinati dalla finestra Origini dati o Casella degli strumenti la cui proprietà CacheInDocument è impostata su True) sono preceduti da un carattere di sottolineatura nella cache. Se ad esempio si crea un DataSet denominato Customers, il nome CachedDataItem sarà _Customers nella cache. Se si utilizza ServerDocument per accedere a questo elemento memorizzato nella cache, è necessario specificare _Customers invece di Customers. |
Per memorizzare dati nella cache del documento utilizzando codice
Dichiarare una proprietà o un campo pubblico per l'elemento dati come un membro di una classe dell'elemento host del progetto, ad esempio la classe ThisDocumen in un progetto Word o la classe ThisWorkbook in un progetto Excel.
Applicare l'attributo CachedAttribute al membro per contrassegnare l'elemento dati da memorizzare nella cache di dati del documento. Nell'esempio seguente, questo attributo viene applicato a una dichiarazione di campo per un oggetto DataSet.
<Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _ Public employeesDataSet As DataSet[Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()] public DataSet employeesDataSet;Aggiungere il codice per creare un'istanza dell'elemento dati e, se possibile, per caricarla dal database.
L'elemento dati viene caricato solo quando viene creato per la prima volta; di conseguenza, la cache resta associata al documento e sarà necessario scrivere altro codice per aggiornarla.
Per memorizzare un dataset nel documento tramite la finestra Proprietà
Aggiungere il dataset al progetto utilizzando gli strumenti della finestra di progettazione di Visual Studio, ad esempio, aggiungendo un'origine dati al progetto mediante la finestra Origini dati.
Creare un'istanza del DataSet se non ne è già disponibile una e selezionare l'istanza nella finestra di progettazione.
Nella finestra Proprietà, impostare la proprietà CacheInDocument su True.
Per ulteriori informazioni, vedere Proprietà nei progetti di Visual Studio Tools per Office.
Nella finestra Proprietà, modificare la proprietà Modifiers impostandola su Public (per impostazione predefinita è impostata su Internal).
Vedere anche
Attività
Procedura: memorizzare nella cache a livello di codice un'origine dati di un documento di Office
Procedura: interrompere la memorizzazione nella cache a livello di codice di un'origine dati
Procedura: memorizzare dati nella cache di un documento protetto da password
Concetti
Memorizzazione di dati nella cache
Accesso ai dati dei documenti sul server