Udostępnij za pośrednictwem

Dane pamięci podręcznej do użycia w trybie offline lub na serwerze

  • Artykuł

Element danych można oznaczyć jako buforowany w dokumencie, aby był dostępny w trybie offline. Umożliwia to również manipulowanie danymi w dokumencie za pomocą innego kodu, gdy dokument jest przechowywany na serwerze.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu dla programów Excel i Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Element danych można oznaczyć jako buforowany, gdy element danych jest zadeklarowany w kodzie lub, jeśli używasz DataSetelementu , ustawiając właściwość w oknie Właściwości . Jeśli buforujesz element danych, który nie jest elementem DataSet lub DataTable, upewnij się, że spełnia kryteria buforowania w dokumencie. Aby uzyskać więcej informacji, zobacz Buforowanie danych.

Uwaga

Zestawy danych utworzone przy użyciu języka Visual Basic oznaczone jako Buforowane i WithEvents (w tym zestawy danych przeciągane z okna Źródła danych lub Przybornik z właściwością CacheInDocument ustawioną na true) mają prefiks podkreślenia do ich nazw w pamięci podręcznej. Jeśli na przykład utworzysz zestaw danych i nadasz mu nazwę Customers, CachedDataItem nazwa będzie _Customers w pamięci podręcznej. W przypadku używania ServerDocument funkcji uzyskiwania dostępu do tego buforowanego elementu należy określić _Customers zamiast klientów.

Aby buforować dane w dokumencie przy użyciu kodu

  1. Zadeklaruj pole publiczne lub właściwość elementu danych jako element członkowski klasy elementu hosta w projekcie, na przykład ThisDocumenklasa t w projekcie programu Word lub ThisWorkbook klasa w projekcie programu Excel.

  2. CachedAttribute Zastosuj atrybut do elementu członkowskiego, aby oznaczyć element danych, który ma być przechowywany w pamięci podręcznej danych dokumentu. W poniższym przykładzie ten atrybut jest stosowany do deklaracji pola dla elementu DataSet.

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

  3. Dodaj kod, aby utworzyć wystąpienie elementu danych i, jeśli ma to zastosowanie, aby załadować go z bazy danych.

    Element danych jest ładowany tylko podczas jego tworzenia; następnie pamięć podręczna pozostaje w dokumencie i musisz napisać inny kod, aby go zaktualizować.

Aby buforować zestaw danych w dokumencie przy użyciu okno Właściwości

  1. Dodaj zestaw danych do projektu przy użyciu narzędzi w projektancie programu Visual Studio, na przykład dodając źródło danych do projektu przy użyciu okna Źródła danych.

  2. Utwórz wystąpienie zestawu danych, jeśli jeszcze go nie masz, a następnie wybierz wystąpienie w projektancie.

  3. W oknie Właściwości ustaw właściwość CacheInDocument na true.

    Aby uzyskać więcej informacji, zobacz Właściwości w projektach pakietu Office.

  4. W oknie Właściwości ustaw właściwość Modyfikatory na Publiczna (domyślnie jest to Wartość Wewnętrzna).

Powiązana zawartość