共用方式為


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

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

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

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

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

若要以程式設計方式快取資料物件

  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");
    }
    

若要停止快取資料物件

  • 呼叫文件或工作表執行個體的 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 專案中的事件

請參閱

工作

HOW TO:快取資料供離線使用或於伺服器上使用

HOW TO:快取受密碼保護文件中的資料

概念

快取資料

存取伺服器文件中的資料

其他資源

儲存資料

Concurrency Control in ADO.NET