Condividi tramite

Memorizzare nella cache i dati per l'uso offline o in un server

  • Articolo

È possibile contrassegnare un elemento di dati da memorizzare nella cache nel documento, in modo che sia disponibile offline. In questo modo è anche possibile che i dati nel documento vengano modificati da altro codice quando il documento viene archiviato in un server.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento per Excel e Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

È possibile contrassegnare un elemento di dati da memorizzare nella cache quando l'elemento di dati viene dichiarato nel codice oppure, se si utilizza un DataSetoggetto , impostando una proprietà nella finestra Proprietà . Se si memorizza nella cache un elemento di dati che non è o DataSet DataTable, assicurarsi che soddisfi i criteri per la memorizzazione nella cache nel documento. Per altre informazioni, vedere Memorizzare nella cache i dati.

Nota

I set di dati creati usando Visual Basic contrassegnati come Memorizzati nella cache e WithEvent (inclusi i set di dati trascinati dalla finestra Origini dati o dalla casella degli strumenti con la proprietà CacheInDocument impostata su True) hanno un carattere di sottolineatura preceduto dai relativi nomi nella cache. Ad esempio, se si crea un set di dati e si assegna il nome Customers, il CachedDataItem nome verrà _Customers nella cache. Quando si usa ServerDocument per accedere a questo elemento memorizzato nella cache, è necessario specificare _Customers anziché clienti.

Per memorizzare nella cache i dati nel documento usando il codice

  1. Dichiarare un campo o una proprietà pubblica per l'elemento di dati come membro di una classe di elementi host nel progetto, ad esempio la ThisDocument classe in un progetto word o la ThisWorkbook classe in un progetto di Excel.

  2. Applicare l'attributo CachedAttribute al membro per contrassegnare l'elemento di dati da archiviare nella cache dei 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 DataSet employeesDataSet;

  3. Aggiungere il codice per creare un'istanza dell'elemento di dati e, se applicabile, per caricarlo dal database.

    L'elemento di dati viene caricato solo quando viene creato per la prima volta; successivamente, la cache rimane con il documento ed è necessario scrivere altro codice per aggiornarlo.

Per memorizzare nella cache un set di dati nel documento usando il Finestra Proprietà

  1. Aggiungere il set di dati al progetto usando strumenti nella finestra di progettazione di Visual Studio, ad esempio aggiungendo un'origine dati al progetto usando la finestra Origini dati.

  2. Creare un'istanza del set di dati se non ne è già disponibile una e selezionare l'istanza nella finestra di progettazione.

  3. Nella finestra Proprietà impostare la proprietà CacheInDocument su True.

    Per altre informazioni, vedere Proprietà nei progetti di Office.

  4. Nella finestra Proprietà impostare la proprietà Modificatori su Public (per impostazione predefinita è Internal).

Contenuto correlato