SqlDataSource.CacheKeyDependency Vlastnost

Definice

Získá nebo nastaví závislost klíče definovanou uživatelem, která je propojena se všemi objekty mezipaměti dat vytvořenými ovládacím prvkem zdroje dat. Při vypršení platnosti klíče jsou explicitně vypršeny všechny objekty 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

String

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

Poznámky

Ovládací SqlDataSource prvek podporuje ukládání dat do mezipaměti. I když jsou data uložená v mezipaměti, Select metoda načte data z mezipaměti místo z podkladové databáze. Po vypršení Select platnosti mezipaměti metoda načte data z podkladové databáze a pak data znovu ukládá do mezipaměti.

Vlastnost můžete nastavit CacheKeyDependency tak, aby vytvořila závislost mezi všemi položkami mezipaměti, které jsou vytvořeny ovládacím SqlDataSource prvku a klíčem. Platnost všech položek mezipaměti můžete kdykoli ukončit prostřednictvím kódu programu vypršením platnosti klíče.

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 objektu SelectCommand, ConnectionStringa SelectParameters vlastností se vytvoří jedinečná položka mezipaměti. Ve SqlDataSource scénářích, kdy ovládací prvky načítají stejná data ze stejné podkladové databáze, může použít několik ovládacích prvků stejné položky mezipaměti.

Důležité

Pokud používáte zosobnění klienta v rámci ověřování Microsoft Windows, data se ukládají do mezipaměti, když k datům přistupuje první uživatel. Pokud jiný uživatel požádá o stejná data, data se načtou z mezipaměti. Data se nenačtou jiným voláním databáze, aby ověřila přístup 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čítání dat bylo ověřeno konfiguracemi zabezpečení pro databázi, nepoužívejte ukládání do mezipaměti.

Platí pro

Viz také