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

Статья
02/20/2013

В документе объект данных добавляется к кэшированным данным с помощью программных средств и метода ведущего элемента StartCaching, такого как Document, Workbook или Worksheet.Удаляет объект данных из кэша данных посредством вызова метода StopCaching ведущего элемента управления.

Метод StartCaching и метод StopCaching являются частными, одна оба присутствуют в IntelliSense.

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

Во время использования метода StartCaching добавления объекта данных к кэшированным данным объект данных не обозначается атрибутом CachedAttribute.Однако объект данных обязан выполнять определенные требования для последующего присоединения к кэшированным данным.Дополнительные сведения см. в разделе Кэширование данных.

Добавление объекта данных в кэш программным образом

Обозначьте объект данных не в методе, а на уровне класса.На данном примере показывается обозначение DataSet с названием dataSet1 и добавление данных в кэш-память программным способом.
```
Public dataSet1 As DataSet
```
```
public DataSet dataSet1;
```
Обработайте объект данных, потом запустите метод StartCaching в документе или экземпляре листа и укажите в названии объекта данных.
```
dataSet1 = New DataSet()

If Not (Me.IsCached("dataSet1")) Then
    Me.StartCaching("dataSet1")
End If
```
```
dataSet1 = new DataSet();

if (!this.IsCached("dataSet1"))
{
    this.StartCaching("dataSet1");
}
```

Прекращение кэширования объекта данных

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

If (Me.IsCached("dataSet1")) Then
    Me.StopCaching("dataSet1")
End If

if (this.IsCached("dataSet1"))
{
    this.StopCaching("dataSet1");
}

Примечание
Не вызывайте StopCaching из обработчика событий для события Shutdown документа или листа.К тому времени, когда произошло событие Shutdown, уже слишком поздно изменять кэш данных.Дополнительные сведения о событии Shutdown см. в разделе События в проектах Office.

Не вызывайте StopCaching из обработчика событий для события Shutdown документа или листа.К тому времени, когда произошло событие Shutdown, уже слишком поздно изменять кэш данных.Дополнительные сведения о событии Shutdown см. в разделе События в проектах Office.

См. также

Задачи

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

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

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

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

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

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

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