共用方式為


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

可以標記要在文件中快取的資料項目,使其可以離線使用。 當文件儲存在伺服器上時,這也使得文件中的資料可以被其他程式碼操作。

適用對象:本主題資訊適用於 Excel 及 Word 的文件層級專案。 如需詳細資訊,請參閱依 Office 應用程式和專案類型提供的功能

當在程式碼中宣告資料項目時,您可以將資料項目標記為要快取,或者,如果您使用 DataSet,則可以透過在 [屬性] 視窗中設定屬性來標記要快取的資料項目。 如果您要快取不是 DataSetDataTable的資料項目,請確定它符合文件中快取的準則。 如需詳細資訊,請參閱快取資料

注意

使用 Visual Basic 建立且標示為 CachedWithEvents 的資料集 (包括從 [資料來源] 視窗或 [工具箱] 拖曳的資料集,或者將 CacheInDocument 屬性設定為 True 的資料集) 在快取的名稱前面都有一個下底線。 例如,如果您建立資料集並將其命名為 Customers,則在快取中 CachedDataItem 的名稱將為 _Customers。 當您使用 ServerDocument 來存取此快取項目時,您必須指定 _Customers,而不是 Customers

使用程式碼快取文件中的資料

  1. 將資料項目的公用欄位或屬性宣告為專案中主項目類別的成員,例如:Word 專案中的 ThisDocument 類別或 Excel 專案中的 ThisWorkbook 類別。

  2. CachedAttribute 屬性套用至成員,以標記要儲存在文件資料快取中的資料項目。 下列範例會將此屬性套用至 DataSet 的欄位宣告。

    [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
    public DataSet employeesDataSet;
    
  3. 新增程式碼以建立資料項目的執行個體,並在適用時從資料庫載入它。

    資料項目只有在第一次建立時才會載入;之後,快取將保留在文件中,您必須撰寫其他程式碼來更新它。

使用 [屬性] 視窗快取文件中的資料集

  1. 例如,使用 Visual Studio 設計工具中的工具將資料集新增至專案,例如:使用 [資料來源] 視窗將資料來源新增至專案。

  2. 如果您還沒有資料集,請建立資料集的執行個體,然後在設計工具中選取執行個體。

  3. 在 [屬性] 視窗中,將 [CacheInDocument] 屬性設定為 [True]。

    如需詳細資訊,請參閱 Office 專案中的屬性

  4. 在 [屬性] 視窗中,將 [修飾詞] 屬性設定為 [公用] (預設為 [內部])。