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à

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. Al termine 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 controllo e dalla SqlDataSource 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 quando nella DataSet modalità. Un'eccezione NotSupportedException viene generata dal Select metodo, se il controllo è impostato sul DataReader valore e la SqlDataSource memorizzazione nella 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 nell'autenticazione di Microsoft 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 eseguendo un'altra chiamata al database per verificare l'accesso dell'utente ai dati. Se si prevede che più utenti accedono ai dati e si desidera 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