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

[アーティクル]
02/21/2013

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

対象: このトピックの情報は、Excel 2013 と Excel 2010、および Word 2013 と Word 2010 のドキュメントレベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクトタイプ別の使用可能な機能」を参照してください。

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

[!メモ]

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

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

データ項目のパブリックフィールドまたはプロパティを、プロジェクトのホスト項目クラス (たとえば、Word プロジェクトの場合は ThisDocument クラス、Excel プロジェクトの場合は ThisWorkbook クラス) のメンバーとして宣言します。
メンバーに CachedAttribute 属性を適用し、データ項目がドキュメントのデータキャッシュに格納されるように設定します。次の例では、この属性を DataSet のフィールド宣言に適用しています。
```
<Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
Public employeesDataSet As DataSet
```
```
[Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
public DataSet employeesDataSet;
```
データ項目のインスタンスを作成し、(該当する場合は) データベースからそれを読み込むためのコードを追加します。

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

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

Visual Studio デザイナーのツールを使用して、データセットをプロジェクトに追加します。たとえば、[データソース] ウィンドウを使用して、データソースをプロジェクトに追加します。
データセットのインスタンスをまだ作成してない場合は作成し、デザイナーでそのインスタンスを選択します。
[プロパティ] ウィンドウで、CacheInDocument プロパティを True に設定します。

詳細については、「Office プロジェクトのプロパティ」を参照してください。
[プロパティ] ウィンドウで、[Modifiers] プロパティを [Public] (既定では、[Internal]) に設定します。