XmlDataSource.CacheKeyDependency プロパティ

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

XmlDataSource.CacheKeyDependency プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

データ ソース コントロールによって作成されたすべてのデータ キャッシュ オブジェクトにリンクされる、ユーザー定義のキー依存関係を取得または設定します。すべてのキャッシュ オブジェクトは、キーの有効期限が切れると、明示的に期限切れになります。

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

Visual Basic (宣言)

Public Overridable Property
 CacheKeyDependency As String

Visual Basic (使用法)

Dim instance As XmlDataSource
Dim value As String

value = instance.CacheKeyDependency

instance.CacheKeyDependency = value

C#

public virtual string CacheKeyDependency {
 get; set; }

C++

public:
virtual property String^ CacheKeyDependency {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_CacheKeyDependency ()

/** @property */
public void set_CacheKeyDependency (String
 value)

JScript

public function get CacheKeyDependency
 () : String

public function set CacheKeyDependency
 (value : String)

プロパティ値
XmlDataSource コントロールによって作成されたすべてのキャッシュ オブジェクトを識別するキー。

解説

XmlDataSource コントロールは、データのキャッシュをサポートしています。データがキャッシュされている間、XmlDataSource は、データを基になるデータ ファイルからではなくキャッシュから取得します。キャッシュの有効期限が切れると、基になるファイルからデータが取得され、そのデータが再びキャッシュに格納されます。

CacheKeyDependency プロパティを設定すると、SqlDataSource コントロールとキーによって作成されたすべてのキャッシュ エントリ間の依存関係を作成できます。キーの有効期限を終了させることにより、すべてのキャッシュ エントリをプログラムによっていつでも無効にできます。

複数の XmlDataSource コントロール間で、同一の XML ファイルと変換ファイルから同一のデータを読み込み、また CacheDuration と CacheExpirationPolicy が同じ設定になっている場合は、CacheKeyDependency を適切なプロパティで作成することによって、同じキャッシュを共有させることができます。

プラットフォーム

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

参照

関連項目
XmlDataSource クラス
XmlDataSource メンバ
System.Web.UI.WebControls 名前空間
EnableCaching