CacheDependency コンストラクタ (String , DateTime)

  • [アーティクル]

ファイルまたはディレクトリへのパスの配列が変更されたかどうかを監視し、その変更の監視を開始する時刻を指定する、CacheDependency クラスの新しいインスタンスを初期化します。

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

構文

'宣言
Public Sub New ( _
    filenames As String(), _
    start As DateTime _
)
'使用
Dim filenames As String()
Dim start As DateTime

Dim instance As New CacheDependency(filenames, start)

public CacheDependency (
    string[] filenames,
    DateTime start
)

public:
CacheDependency (
    array<String^>^ filenames, 
    DateTime start
)

public CacheDependency (
    String[] filenames, 
    DateTime start
)

public function CacheDependency (
    filenames : String[], 
    start : DateTime
)

適用できません。

パラメータ

  • filenames
    キャッシュされているオブジェクトが依存しているファイルまたはディレクトリへのパスの配列。これらのリソースのいずれかが変更されると、キャッシュされているオブジェクトは無効になり、キャッシュから削除されます。
  • start
    配列内のオブジェクトの最終更新日時を突き合わせて確認する日時。

解説

filenames パラメータで指定したディレクトリまたはファイルがファイル システム内に見つからない場合、それらは存在しないものと見なされます。依存関係を持つオブジェクトを Cache に追加するときに、指定されたディレクトリまたはファイルがない場合は、キャッシュされているオブジェクトは、ディレクトリまたはファイルの作成時に Cache から削除されます。

たとえば、c:\stocks\xyz.dat というファイル パスへの依存関係を持つオブジェクトを Cache に追加するとします。CacheDependency オブジェクトが作成されるときに xyz.dat ファイルが見つからない場合でも、後でそのファイルが作成されるとキャッシュされたオブジェクトは削除されます。

メモメモ :

変更の追跡がすぐに開始されます。この追跡は、start パラメータに直接基づくものではありません。start パラメータを使用して過去の日時を渡し、filenames パラメータで渡された配列の最終更新日時をこれと突き合わせて確認します。配列内の任意のオブジェクトの最終更新日時が start パラメータで渡された日時よりも後の場合、キャッシュされた項目は Cache から削除されます。

使用例

System.Web.Caching.Cache.Insert メソッド呼び出しでパラメータ引数にオブジェクトが含められたときに、2 つの XML ファイルと DateTime.Now 値を渡す CacheDependency オブジェクトを作成するコード例を次に示します。

    ' Create a DateTime object that determines
    '  when dependency monitoring begins.
    Dim dt As DateTime = DateTime.Now

    ' Make key1 dependent on several files.
    Dim files(2) as String
    files(0) = Server.MapPath("isbn.xml")
    files(1) = Server.MapPath("customer.xml")
    Dim dependency as new CacheDependency(files, dt)

    Cache.Insert("key1", "Value 1", dependency)
End If

// Create a DateTime object that determines
// when dependency monitoring begins.
DateTime dt = DateTime.Now;
    // Make key1 dependent on several files.
    String[] files = new String[2];
    files[0] = Server.MapPath("isbn.xml");
    files[1] = Server.MapPath("customer.xml");
    CacheDependency dep = new CacheDependency(files, dt);

    Cache.Insert("key1", "Value 1", dep);
}

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

CacheDependency クラス
CacheDependency メンバ
System.Web.Caching 名前空間
Cache

その他の技術情報

アプリケーション データのキャッシュ