方法 : オフラインで使用するデータまたはサーバー上で使用するデータをキャッシュする

更新 : 2007 年 11 月

ドキュメント内でキャッシュするデータ項目を指定して、オフラインで使用できます。ドキュメントがサーバーに保存されているときに、他のコードからドキュメント内のデータを使用することもできます。

キャッシュするデータ項目は、データ項目をコードで宣言するときに指定するか、DataSet を使用する場合は、プロパティ ウィンドウのプロパティを設定して指定します。DataSet または DataTable ではないデータ項目をキャッシュする場合は、ドキュメントにキャッシュするための基準を満たすことを確認します。詳細については、「キャッシュされたデータ」を参照してください。

メモ :
Visual Basic で Cached および WithEvents を指定して作成したデータセット ([データ ソース] ウィンドウまたはツールボックスからドラッグされ、CacheInDocument プロパティが True に設定されたデータセットを含む) は、アンダースコアで始まる名前でキャッシュに格納されます。たとえば、Customers という名前のデータセットを作成した場合、CachedDataItem の名前はキャッシュ内では _Customers です。キャッシュされた項目へのアクセスに ServerDocument を使用する場合、Customers ではなく _Customers を指定する必要があります。

コードを使用してドキュメント内のデータをキャッシュするには

1. データ項目のパブリック フィールドまたはプロパティを、プロジェクトのホスト項目クラス (たとえば、Word プロジェクトの場合は ThisDocument クラス、Excel プロジェクトの場合は ThisWorkbook クラス) のメンバとして宣言します。

2. メンバに CachedAttribute 属性を適用し、データ項目がドキュメントのデータ キャッシュに格納されるように設定します。次の例では、この属性を DataSet のフィールド宣言に適用しています。

   <Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
   Public employeesDataSet As DataSet
   

   [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
   public DataSet employeesDataSet;
   

3. データ項目のインスタンスを作成し、(該当する場合は) データベースからそれを読み込むためのコードを追加します。

   データ項目が読み込まれるのは最初の作成時のみで、その後はキャッシュがドキュメント内に残されます。キャッシュの内容を更新するには他のコードを作成する必要があります。

プロパティ ウィンドウを使用してドキュメント内のデータセットをキャッシュするには

1. Visual Studio デザイナのツールを使用して、データセットをプロジェクトに追加します。たとえば、[データ ソース] ウィンドウを使用して、データ ソースをプロジェクトに追加します。

2. データセットのインスタンスをまだ作成してない場合は作成し、デザイナでそのインスタンスを選択します。

3. [プロパティ] ウィンドウで、CacheInDocument プロパティを True に設定します。

   詳細については、「Visual Studio Tools for Office プロジェクトのプロパティ」を参照してください。

4. [プロパティ] ウィンドウで、[Modifiers] プロパティを [Public] (既定では、[Internal]) に設定します。

参照

処理手順

方法 : Office ドキュメント内のデータ ソースをプログラムでキャッシュする

方法 : データ ソースのキャッシュをプログラムで停止する

方法 : パスワードで保護されたドキュメント内のデータをキャッシュする

概念

キャッシュされたデータ

サーバー上のドキュメント内のデータへのアクセス

その他の技術情報

データの保存

ADO.NET における同時実行制御