SqlDataSource.CacheKeyDependency Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une dépendance de clé définie par l’utilisateur liée à tous les objets de cache de données créés par le contrôle de source de données. Tous les objets de cache ont expiré explicitement lorsque la clé a expiré.
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 StringValeur de propriété
Clé qui identifie tous les objets de cache créés par le SqlDataSource.
Remarques
Le SqlDataSource contrôle prend en charge la mise en cache des données. Pendant que les données sont mises en cache, la Select méthode récupère les données du cache plutôt que de la base de données sous-jacente. Lorsque le cache expire, la Select méthode récupère les données de la base de données sous-jacente, puis met à nouveau en cache les données.
Vous pouvez définir la CacheKeyDependency propriété pour créer une dépendance entre toutes les entrées de cache créées par le SqlDataSource contrôle et la clé. Vous pouvez expirer par programmation toutes les entrées du cache à tout moment en arrivant à expiration de la clé.
Le SqlDataSource contrôle ne peut mettre en cache les données qu’en DataSet mode. Une NotSupportedException exception est levée par la Select méthode, si le SqlDataSource contrôle est défini sur la DataReader valeur et la mise en cache est également activée.
Une entrée de cache unique est créée pour chaque combinaison des propriétés et ConnectionStringSelectParameters des SelectCommandpropriétés. Plusieurs SqlDataSource contrôles peuvent utiliser les mêmes entrées de cache dans les scénarios où les contrôles chargent les mêmes données à partir de la même base de données sous-jacente.
Important
Lorsque vous utilisez l’emprunt d’identité client sous l’authentification Microsoft Windows, les données sont mises en cache lorsque le premier utilisateur accède aux données. Si un autre utilisateur demande les mêmes données, les données sont récupérées à partir du cache. Les données ne sont pas récupérées en effectuant un autre appel à la base de données pour vérifier l’accès de l’utilisateur aux données. Si vous attendez que plusieurs utilisateurs accèdent aux données et que vous souhaitez que chaque récupération des données soit vérifiée par les configurations de sécurité de la base de données, n’utilisez pas la mise en cache.
