Практическое руководство. Кэширование данных для автономного использования или для использования на сервере

Обновлен: Ноябрь 2007

Применение
Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Версия Microsoft Office Выпуск 2007 системы Microsoft Office Microsoft Office 2003 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

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

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

Примечание.

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

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

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

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

   <Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
   Public employeesDataSet As DataSet
   

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

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

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

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

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

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

3. В окне Свойства установите свойству CacheInDocument значение True.

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

4. В окне Свойства установите, что свойство Модификаторы равным Общедоступный (по умолчанию оно равно Для внутреннего использования).

См. также

Задачи

Практическое руководство. Программное кэширование источника данных в документе MS Office.

Практическое руководство. Программная остановка кэширования источника данных

Практическое руководство. Кэширование данных в документе, защищенном паролем

Основные понятия

Кэширование данных

Доступ к данным в документах на сервере

Другие ресурсы

Сохранение данных

Управление одновременным доступом в ADO.NET