CacheDependency クラス

.NET Framework クラス ライブラリ リファレンス

CacheDependency クラス

ASP.NET アプリケーションの Cache オブジェクトに格納されている項目と、ファイル、キャッシュ キー、ファイルまたキャッシュ キーの配列、または別の CacheDependency オブジェクトとの間に依存関係を確立します。CacheDependency クラスは依存関係を監視し、依存関係が変更されたときにキャッシュされた項目が自動的に削除されるようにします。

名前空間: System.Web.Caching
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class CacheDependency
    Implements IDisposable

Visual Basic (使用法)

Dim instance As CacheDependency

C#

public class CacheDependency : IDisposable

C++

public ref class CacheDependency : IDisposable

J#

public class CacheDependency implements IDisposable

JScript

public class CacheDependency implements IDisposable

解説

ファイルやファイルの配列などの別のオブジェクトに依存しているキャッシュに項目を追加すると、依存する項目はオブジェクトが変更されるときにキャッシュから自動的に削除されます。たとえば、XML ファイルのデータに基づいて DataSet オブジェクトを作成するとします。DataSet を XML ファイルに依存させる CacheDependency オブジェクトを使用して、DataSet をキャッシュに追加できます。この XML ファイルが変更されると、DataSet はキャッシュから削除されます。

Add メソッドと System.Web.Caching.Cache.Insert メソッドを使用して、依存関係を持つ項目をアプリケーションのキャッシュに追加できます。依存関係を持つ項目をキャッシュに追加するのに、Item プロパティを使用することはできません。

依存関係を設定するには、CacheDependency クラスのインスタンスを作成し、ファイル、キー、または項目が依存するディレクトリを指定します。次に、この依存関係を Add メソッドまたは System.Web.Caching.Cache.Insert メソッドに渡します。CacheDependency インスタンスは、単一のファイルまたはディレクトリ、ファイルまたはディレクトリの配列、ファイルまたはディレクトリの配列に (Cache オブジェクトに格納されている他の項目を表す) キャッシュ キーの配列を加えたものを表すことができます。

使用例

HasChanged プロパティを使用して、Cache の項目に対する前の要求以降に CacheDependency が変更されたかどうかを確認するコード例を次に示します。start パラメータに渡される dt 値は、DateTime.Now に設定されます。

Visual Basic

' Insert the cache item.
Dim dep As New CacheDependency(fileName,
 dt)
myCache.Insert("key", "value",
 dep)

' Check whether CacheDependency.HasChanged is true.
If dep.HasChanged Then
   Response.Write("<p>The dependency has changed.")
Else
   Response.Write("<p>The dependency has not changed.")
End If 

C#

// Insert the cache item.
CacheDependency dep = new CacheDependency(fileName, dt);
cache.Insert("key", "value", dep);

// Check whether CacheDependency.HasChanged is true.
if (dep.HasChanged)
  Response.Write("<p>The dependency has changed.");  
else Response.Write("<p>The dependency has not changed.");

J#

// Insert the cache item.
CacheDependency dep =  new CacheDependency(fileName, dt);
cache.Insert("key", "value", dep);

// Check whether CacheDependency.HasChanged is true.
if (dep.get_HasChanged()) {
    get_Response().Write("<p>The dependency has changed.");
}
else {
    get_Response().Write("<p>The dependency has not changed.");
} 

継承階層

System.Object
  System.Web.Caching.CacheDependency
     System.Web.Caching.AggregateCacheDependency
     System.Web.Caching.SqlCacheDependency

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CacheDependency メンバ
System.Web.Caching 名前空間
Cache クラス
Insert
その他の技術情報
アプリケーション データのキャッシュ