SqlDataSource.CacheKeyDependency プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソース コントロールによって作成されたすべてのデータ キャッシュ オブジェクトにリンクされる、ユーザー定義のキー依存関係を取得または設定します。 キーの有効期限が切れると、すべてのキャッシュ オブジェクトが明示的に期限切れになります。
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, setPublic Overridable Property CacheKeyDependency As Stringプロパティ値
SqlDataSource によって作成されたすべてのキャッシュ オブジェクトを識別するキー。
注釈
コントロールは SqlDataSource データ キャッシュをサポートします。 データがキャッシュされている間、 Select このメソッドは基になるデータベースからではなく、キャッシュからデータを取得します。 キャッシュの有効期限が切れると、メソッドは Select 基になるデータベースからデータを取得し、データをもう一度キャッシュします。
このプロパティを CacheKeyDependency 設定して、コントロールによって作成されたすべてのキャッシュ エントリとキーの間に依存関係を SqlDataSource 作成できます。 キーの有効期限を切ることで、プログラムによってすべてのキャッシュ エントリをいつでも期限切れにできます。
コントロールは SqlDataSource 、モードの場合にのみデータを DataSet キャッシュできます。 NotSupportedExceptionコントロールが値にSelect設定DataReaderされ、キャッシュも有効になっている場合SqlDataSource、メソッドによって例外がスローされます。
プロパティのSelectParameters組み合わせごとに一意のキャッシュ エントリがSelectCommandConnectionString作成されます。 複数 SqlDataSource のコントロールは、コントロールが同じ基になるデータベースから同じデータを読み込むシナリオで、同じキャッシュ エントリを使用できます。
重要
Microsoft Windows 認証 でクライアントの偽装を使用している場合、最初のユーザーがデータにアクセスすると、データがキャッシュされます。 別のユーザーが同じデータを要求すると、キャッシュからデータが取得されます。 データに対するユーザーのアクセスを確認するためにデータベースを別の呼び出しを行うことで、データは取得されません。 複数のユーザーがデータにアクセスする必要があり、データベースのセキュリティ構成によってデータを取得するたびに検証する場合は、キャッシュを使用しないでください。