Практическое руководство. Кэширование данных для автономного использования или для использования на сервере
Можно пометить элемент данных, который следует кэшировать в документе, чтобы он был доступен автономно.Также можно сделать возможным программное управление данными в документе, хранящемся на сервере.
Применение. Сведения этого раздела применяются к проектам уровня документа для следующих приложений: Excel 2013 и Excel 2010; Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.
Можно пометить элемент данных, который следует кэшировать, если элемент данных объявлен в вашем коде, или, если Вы используете DataSet, с помощью свойства в окне Свойства.Если кэшируется элемент данных, не являющийся DataSet или DataTable, убедитесь в том, что он соответствует критериям кэширования в документе.Дополнительные сведения см. в разделе Кэширование данных.
![]() |
---|
Наборы данных, созданные при помощи Visual Basic и помеченные как Cached и WithEvents (включая наборы данных, взятых из окна Источники данных или из окна Панель элементов, свойство CacheInDocument которого установлено равным True), содержат подчеркивания в своих именах в кэше.Например, если создается набор данных с именем Customers, имя CachedDataItem в кэше будет _Customers.При использовании ServerDocument для доступа к этому кэшированному элементу, необходимо указывать _Customers, а не Customers. |
Кэширование данных в документе при помощи кода
Объявите открытое поле или свойство для элемента данных как член ведущего класса элементов в проекте, например, класс ThisDocument в проекте Word или класс ThisWorkbook в проекте Excel.
Примените атрибут CachedAttribute к члену для отметки элемента данных, подлежащего сохранению в кэше данных документа.Следующий пример применяет этот атрибут к объявлению поля для DataSet.
<Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _ Public employeesDataSet As DataSet
[Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()] public DataSet employeesDataSet;
Добавьте код для создания экземпляра элемента данных и, если применимо, загрузки его из базы данных.
Элемент данных загружается, если только он был создан в первый раз; после этого в кэше остается документ, и следует написать другой код, чтобы обновить его.
Кэширование набора данных в документе при помощи окна "Свойства"
Добавьте набор данных в проект при помощи инструментов конструктора Visual Studio, например, используя окно Источники данных.
Создайте экземпляр набора данных, если он еще не создан, и выберите экземпляр в конструкторе.
В окне Свойства установите свойству CacheInDocument значение True.
Дополнительные сведения см. в разделе Свойства в проектах Office.
В окне Свойства установите, что свойство Модификаторы равным Общедоступный (по умолчанию оно равно Для внутреннего использования).
См. также
Задачи
Практическое руководство. Программное кэширование источника данных в документе MS Office.
Практическое руководство. Кэширование данных в документе, защищенном паролем