ObjectDataSource.CacheKeyDependency プロパティ

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

ObjectDataSource.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 ObjectDataSource
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)

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

解説

キーの有効期限が切れると、すべてのキャッシュ オブジェクトが明示的に期限切れになります。これにより、独自のページ コードの ObjectDataSource によって作成されたキャッシュ エントリをプログラムによって無効化できます。

ObjectDataSource コントロールは、データのキャッシュをサポートしています。データがキャッシュされている間、Select メソッドの呼び出しによって、データは ObjectDataSource が使用するビジネス オブジェクトからではなく、キャッシュから取得されます。キャッシュの有効期限が切れると、Select メソッドはビジネス オブジェクトからデータを取得し、そのデータを再びキャッシュします。

EnableCaching プロパティが true に設定され、CacheDuration プロパティ (キャッシュ エントリが破棄されるまでの秒数、つまり、キャッシュにデータが格納される秒数) が 0 より大きい値に設定されている場合、ObjectDataSource コントロールはデータを自動的にキャッシュします。値 0 は、キャッシュ時間が制限されていないことを示します。

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

CacheDuration、CacheExpirationPolicy、TypeName、SelectMethod、および SelectParameters の各プロパティの組み合わせごとに一意のキャッシュ エントリが作成されます。同じ型、メソッド、およびパラメータを使用してデータを読み込むシナリオでは、複数の ObjectDataSource コントロールで同じキャッシュ エントリを使用できます。

プラットフォーム

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

参照

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