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


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

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

Применение. Сведения этого раздела применяются к проектам уровня документа для следующих приложений: Excel 2013 и Excel 2010; Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

Можно пометить элемент данных, который следует кэшировать, если элемент данных объявлен в вашем коде, или, если Вы используете 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.

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

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

См. также

Задачи

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

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

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

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

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

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