Sdílet prostřednictvím


SqlDataSource.CacheKeyDependency Vlastnost

Definice

Získá nebo nastaví uživatelem definovaný klíč závislost, která je propojena se všemi objekty mezipaměti dat, které jsou vytvořeny ovládacím prvkem zdroje dat. Po vypršení platnosti klíče explicitně vyprší platnost všech objektů mezipaměti.

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

Hodnota vlastnosti

Klíč, který identifikuje všechny objekty mezipaměti vytvořené objektem SqlDataSource.

Poznámky

Ovládací SqlDataSource prvek podporuje ukládání dat do mezipaměti. Když jsou data uložená v mezipaměti, Select metoda načítá data z mezipaměti, nikoli z podkladové databáze. Když platnost mezipaměti vyprší, Select metoda načte data z podkladové databáze a pak je znovu ukládá do mezipaměti.

Nastavením vlastnosti můžete CacheKeyDependency vytvořit závislost mezi všemi položkami mezipaměti vytvořenými ovládacím prvkem SqlDataSource a klíčem . Vypršení platnosti klíče můžete kdykoli programově ukončit všechny položky mezipaměti.

Ovládací SqlDataSource prvek může ukládat data do mezipaměti pouze v DataSet režimu . Metoda NotSupportedException vyvolá Select výjimku, pokud SqlDataSource je ovládací prvek nastaven na DataReader hodnotu a ukládání do mezipaměti je také povoleno.

Pro každou kombinaci SelectCommandvlastností , ConnectionStringa SelectParameters se vytvoří jedinečná položka mezipaměti. Více SqlDataSource ovládacích prvků může používat stejné položky mezipaměti ve scénářích, kdy ovládací prvky načítají stejná data ze stejné podkladové databáze.

Důležité

Pokud používáte zosobnění klienta v rámci ověřování systému Microsoft Windows, data se ukládají do mezipaměti, když k datům přistupuje první uživatel. Pokud o stejná data požádá jiný uživatel, načtou se data z mezipaměti. Data se nenačtou jiným voláním databáze za účelem ověření přístupu uživatele k datům. Pokud očekáváte, že k datům bude přistupovat více uživatelů a chcete, aby každé načtení dat bylo ověřeno konfigurací zabezpečení databáze, nepoužívejte ukládání do mezipaměti.

Platí pro

Viz také