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

更新：2007 年 11 月

适用于
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 项目类型 文档级项目 Microsoft Office 版本 2007 Microsoft Office system Microsoft Office 2003 有关更多信息，请参见按应用程序和项目类型提供的功能。

可以通过调用宿主项（如 Document、Workbook 或 Worksheet）的 StartCaching 方法，以编程方式将数据对象添加到文档的数据缓存中。StartCaching 方法是私有方法，但它出现在 IntelliSense 中。

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

以编程方式缓存数据对象

1. 在类级别而不要在方法内部声明数据对象。本示例假定您要声明一个名为 dataSet1 的 DataSet，您要以编程方式缓存该数据集。

   Public dataSet1 As DataSet
   

   public DataSet dataSet1;
   

2. 实例化数据对象，然后调用文档或工作表实例的 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");
   }
   

请参见

任务

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

如何：以编程方式停止缓存数据源

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

概念

缓存数据

访问服务器上的文档数据

其他资源

保存数据

ADO.NET 中的并发控制