HOW TO：快取資料供離線使用或於伺服器上使用
更新：2007 年 11 月
適用於 |
|---|
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 專案類型
Microsoft Office 版本
如需詳細資訊，請參閱依應用程式和專案類型提供的功能。 |
您可以將文件中的資料項目標示為快取，使其可以在離線時使用。而在文件存放在伺服器上時，這也可以讓其他的程式碼操作文件中的資料。
您可以在程式碼中宣告資料項目，或是當使用 DataSet 時，藉由在 [屬性] 視窗中設定屬性，將資料項目標示為快取。如果您要快取不是 DataSet 或 DataTable 的資料項目，請確認此項目符合在文件中快取的準則。如需詳細資訊，請參閱快取資料。
.gif "注意事項") 注意事項： |
|---|
使用 Visual Basic 建立且標記為 Cached 和 WithEvents 的資料集 (包括從 [資料來源] 視窗或 [工具箱] 拖曳且將 [CacheInDocument] 屬性設定為 [True] 的資料集) 會在快取中其名稱前加上底線。例如，如果建立資料集並將其命名為 Customers，其 CachedDataItem 在快取中的名稱將會是 _Customers。在使用 ServerDocument 存取此快取項目時，必須指定 _Customers 而不是 Customers。 |
若要使用程式碼快取文件中的資料
將資料項目的公用欄位或屬性宣告為專案中主項目類別的成員，例如 Word 專案中的 ThisDocument 類別或 Excel 專案中的 ThisWorkbook 類別。
將 CachedAttribute 屬性 (Attribute) 套用至成員，以標示要儲存在文件資料快取中的資料項目。下列程式碼範例會將這個屬性套用至 DataSet 的欄位宣告。
<Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _ Public employeesDataSet As DataSet[Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()] public DataSet employeesDataSet;加入程式碼以建立資料項目的執行個體，以及在可能情況下將其從資料庫載入。
資料項目只會在第一次建立時載入，此後快取會隨同文件保留，而您必須撰寫其他的程式碼來更新它。
若要使用屬性視窗快取文件中的資料集
使用 Visual Studio 設計工具中的工具，將資料集加入至專案，例如使用 [資料來源] 視窗，將資料來源加入至專案。
如果沒有資料集的執行個體，請建立一個，並在設計工具中選取該執行個體。
在 [屬性] 視窗中，將 [CacheInDocument] 屬性設定為 [True]。
如需詳細資訊，請參閱 Visual Studio Tools for Office 專案中的屬性。
在 [屬性] 視窗中，將 [Modifiers] 屬性設定為 [Public] (預設為 [Internal])。
請參閱
工作
HOW TO：以程式設計方式快取 Office 文件的資料來源