Поделиться через

Кэшировать данные для использования в автономном режиме или на сервере

  • Статья

Вы можете пометить элемент данных для кэширования в документе, чтобы он был доступен в автономном режиме. Это также позволяет управлять данными в документе с помощью другого кода при хранении документа на сервере.

Область применения. Сведения в этом разделе относятся к проектам уровня документа для Excel и Word. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

Вы можете пометить элемент данных, который будет кэширован при объявлении элемента данных в коде или, если используется DataSet, задав свойство в окне свойств . Если вы кэширование элемента данных, который не является или DataSet DataTable, убедитесь, что он соответствует критериям кэширования в документе. Дополнительные сведения см. в разделе "Кэш данных".

Примечание.

Наборы данных, созданные с помощью Visual Basic, помеченные как Кэшированные и WithEvents (включая наборы данных, перетаскиваемые из окна источников данных или панели элементов с свойством CacheInDocument с значением True), имеют префикс подчеркивания в их именах в кэше. Например, если вы создадите набор данных и назовете его "Клиенты", CachedDataItem имя будет _Customers в кэше. ServerDocument При доступе к этому кэшированному элементу необходимо указать _Customers вместо клиентов.

Кэширование данных в документе с помощью кода

  1. Объявите общедоступное поле или свойство элемента данных в качестве члена класса элемента узла в проекте, например ThisDocument класс в проекте Word или ThisWorkbook класс в проекте Excel.

  2. CachedAttribute Примените атрибут к элементу, чтобы пометить элемент данных, хранящийся в кэше данных документа. В следующем примере этот атрибут применяется к объявлению поля для DataSetобъекта.

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

  3. Добавьте код для создания экземпляра элемента данных и, если применимо, для его загрузки из базы данных.

    Элемент данных загружается только при первом создании; После этого кэш остается в документе и необходимо написать другой код, чтобы обновить его.

Кэширование набора данных в документе с помощью окно свойств

  1. Добавьте набор данных в проект с помощью средств в конструкторе Visual Studio, например путем добавления источника данных в проект с помощью окна "Источники данных".

  2. Создайте экземпляр набора данных, если у вас еще нет этого набора данных и выберите экземпляр в конструкторе.

  3. В окне "Свойства" задайте для свойства CacheInDocument значение True.

    Дополнительные сведения см. в разделе "Свойства" в проектах Office.

  4. В окне "Свойства" задайте для свойства Modifiers значение Public (по умолчанию оно является внутренним).

Связанный контент