如何：缓存数据以便脱机使用或在服务器上使用
可以在文档中将某个数据项标记为要进行缓存，以便脱机使用该数据项。这样，当文档存储在服务器中时，其他代码也可以对文档中的相应数据进行操作。
**适用于：**本主题中的信息适用于以下应用程序的文档级项目：Excel 2013 和 Excel 2010；Word 2013 和 Word 2010。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。
在代码中声明某个数据项时，可以将该数据项标记为要进行缓存；如果正在使用 DataSet，可以在**“属性”**窗口中设置相应属性来完成这一操作。如果要缓存的数据项不是 DataSet 或 DataTable，请确保该数据项满足在文档中缓存的条件。有关更多信息，请参见缓存数据。
.gif "说明") 说明 |
|---|
在缓存中，以下数据集的名称前有一个下划线前缀：使用 Visual Basic 创建的且标记为 Cached 和 WithEvents 的数据集，包括从“数据源”窗口或“工具箱”中拖动的且“CacheInDocument”属性被设置为“True”的数据集。例如，如果创建了一个数据集并将其命名为“Customers”，则 CachedDataItem 在缓存中的名称将是“_Customers”。当使用 ServerDocument 访问此缓存项时，必须指定 _Customers 而不是 Customers。 |
使用代码在文档中缓存数据
将数据项的某个公共字段或属性声明为项目中的宿主项类的成员，例如 Word 项目中的 ThisDocument 类或 Excel 项目中的 ThisWorkbook 类。
将 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 项目中的属性。
在**“属性”窗口中，将“Modifiers”属性设置为“Public”（默认情况下为“Internal”**）。