SqlDataSource.CacheKeyDependency プロパティ

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

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

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

public virtual string CacheKeyDependency { get; set; }

member this.CacheKeyDependency : string with get, set

Public Overridable Property CacheKeyDependency As String

プロパティ値

String

SqlDataSource によって作成されたすべてのキャッシュ オブジェクトを識別するキー。

注釈

コントロールは SqlDataSource データ キャッシュをサポートしています。 データがキャッシュされている間、 Select メソッドは基になるデータベースからではなく、キャッシュからデータを取得します。 キャッシュの有効期限が切れると、 メソッドは Select 基になるデータベースからデータを取得し、データをもう一度キャッシュします。

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

コントロールは SqlDataSource 、モードの場合にのみデータを DataSet キャッシュできます。 NotSupportedExceptionコントロールが値にSelect設定DataReaderされ、キャッシュも有効になっている場合SqlDataSourceは、 メソッドによって例外がスローされます。

、、および SelectParameters の各プロパティの組み合わせごとに、一意のSelectCommandConnectionStringキャッシュ エントリが作成されます。 コントロールが同じ基になるデータベースから同じデータを読み込むシナリオでは、複数 SqlDataSource のコントロールで同じキャッシュ エントリを使用できます。

重要

Microsoft Windows 認証でクライアントの偽装を使用している場合、最初のユーザーがデータにアクセスすると、データがキャッシュされます。 別のユーザーが同じデータを要求すると、データはキャッシュから取得されます。 データに対するユーザーのアクセスを確認するためにデータベースを別の呼び出しを行うことで、データは取得されません。 複数のユーザーがデータにアクセスする必要があり、データベースのセキュリティ構成によってデータを取得するたびに検証する場合は、キャッシュを使用しないでください。

こちらもご覧ください

• CacheDuration
• データ ソース Web サーバー コントロール
• SqlDataSource Web Server コントロールの概要