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

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

Document、Workbook、Worksheet などのホスト項目の StartCaching メソッドを呼び出し、プログラムによってドキュメント内のデータキャッシュにデータオブジェクトを追加できます。ホスト項目の StopCaching メソッドを呼び出して、データキャッシュからデータオブジェクトを削除します。

StartCaching メソッドおよび StopCaching メソッドは両方ともプライベートですが、IntelliSense に表示されます。

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

StartCaching メソッドを使用し、データオブジェクトをデータキャッシュに追加すると、データオブジェクトを CachedAttribute 属性で宣言する必要がありません。ただし、データオブジェクトは、データキャッシュに追加するための特定の要件を満たす必要があります。詳細については、「キャッシュされたデータ」を参照してください。

データオブジェクトをプログラムでキャッシュするには

データオブジェクトをメソッド内部ではなくクラスレベルで宣言します。この例では、プログラムでキャッシュする、dataSet1 という名前の DataSet を宣言していることを前提とします。
```
Public dataSet1 As DataSet
```
```
public DataSet dataSet1;
```
データオブジェクトをインスタンス化した後、ドキュメントまたはワークシートのインスタンスの 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 プロジェクトのイベント」を参照してください。