SqlDataSource.CacheKeyDependency Proprietà

Definizione

Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti cache dati creati dal controllo origine dati. Tutti gli oggetti relativi alla cache scadono in modo esplicito quando scade la chiave.

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

Valore della proprietà

String

Chiave che identifica tutti gli oggetti relativi alla cache creati dall'oggetto SqlDataSource.

Commenti

Il controllo supporta la SqlDataSource memorizzazione nella cache dei dati. Mentre i dati vengono memorizzati nella cache, il Select metodo recupera i dati dalla cache anziché dal database sottostante. Alla scadenza della cache, il Select metodo recupera i dati dal database sottostante e quindi memorizza nuovamente nella cache i dati.

È possibile impostare la CacheKeyDependency proprietà per creare una dipendenza tra tutte le voci della cache create dal SqlDataSource controllo e dalla chiave. È possibile scadere a livello di codice tutte le voci della cache in qualsiasi momento scadendo la chiave.

Il SqlDataSource controllo può memorizzare nella cache i dati solo in DataSet modalità . Viene NotSupportedException generata un'eccezione dal Select metodo , se il SqlDataSource controllo è impostato sul valore e la memorizzazione nella DataReader cache è abilitata.

Viene creata una voce di cache univoca per ogni combinazione delle SelectCommandproprietà , ConnectionStringe SelectParameters . Più SqlDataSource controlli possono usare le stesse voci della cache negli scenari in cui i controlli caricano gli stessi dati dallo stesso database sottostante.

Importante

Quando si usa la rappresentazione client in Microsoft autenticazione di Windows, i dati vengono memorizzati nella cache quando il primo utente accede ai dati. Se un altro utente richiede gli stessi dati, i dati vengono recuperati dalla cache. I dati non vengono recuperati effettuando un'altra chiamata al database per verificare l'accesso dell'utente ai dati. Se si prevede che più di un utente accinga ai dati e si vuole che ogni recupero ai dati venga verificato dalle configurazioni di sicurezza per il database, non usare la memorizzazione nella cache.

Si applica a

Vedi anche