如何：以编程方式在 Office 文档中缓存数据源

项目
08/12/2011

可以通过调用宿主项（如 Document、Workbook 或 Worksheet）的 StartCaching 方法，以编程方式将数据对象添加到文档的数据缓存中。通过调用宿主项的 StopCaching 方法来移除数据缓存中的数据对象。

StartCaching 方法和 StopCaching 方法都是私有方法，但它们出现在 IntelliSense 中。

**适用于：**本主题中的信息适用于以下应用程序的文档级项目：Excel 2007 和 Excel 2010；Word 2007 和 Word 2010。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

使用 StartCaching 方法向数据缓存添加数据对象时，不需要使用 CachedAttribute 特性声明数据对象。但是，数据对象必须满足某些要求才能添加到数据缓存中。有关更多信息，请参见缓存数据。

以编程方式缓存数据对象

在类级别而不要在方法内部声明数据对象。本示例假定您要声明一个名为 dataSet1 的 DataSet，您要以编程方式缓存该数据集。
```
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 方法并传入数据对象的名称。此示例假定您具有一个名为 dataSet1 的要停止缓存的 DataSet。
```
If (Me.IsCached("dataSet1")) Then
    Me.StopCaching("dataSet1")
End If
```
```
if (this.IsCached("dataSet1"))
{
    this.StopCaching("dataSet1");
}
```
提示

不要从文档或工作表的 Shutdown 事件的事件处理程序调用 StopCaching。当引发了 Shutdown 事件时，就来不及修改数据缓存了。有关 Shutdown 事件的更多信息，请参见Office 项目中的事件。

请参见

任务

如何：缓存数据以便脱机使用或在服务器上使用

如何：在受密码保护的文档中缓存数据

概念

访问服务器上的文档数据

其他资源

ADO.NET 中的并发控制