HOW TO：以程式設計方式快取 Office 文件的資料來源

您可以用程式設計方式將資料物件加入至文件的資料快取中，方法是呼叫主項目 (例如 Document、Workbook 或 Worksheet) 的 StartCaching 方法。透過呼叫主項目的 StopCaching 方法，移除資料快取中的資料物件。

雖然 StartCaching 方法和 StopCaching 方法都是私用的 (Private)，不過它們會出現在 IntelliSense 中。

**適用於：**本主題中的資訊適用於下列應用程式的文件層級專案：Excel 2007 和 Excel 2010、Word 2007 和 Word 2010。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

當您使用 StartCaching 方法，將資料物件加入至資料快取時，不需要使用 CachedAttribute 屬性 (Attribute) 宣告資料物件。不過，資料物件必須符合某些需求，才能加入至資料快取。如需詳細資訊，請參閱快取資料。

執行個體化資料物件，然後呼叫文件或工作表執行個體的 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 專案中的事件。

請參閱