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

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

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

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

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

实例化数据对象，然后调用文档或工作表实例的 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 项目中的事件。

请参见