Partager via

SqlDataSource.CacheKeyDependency Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit une dépendance de clé définie par l'utilisateur qui est liée à tous les objets du cache de données créés par le contrôle de source de données. Tous les objets du cache expirent explicitement lorsque la clé expire.

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

Valeur de propriété

String

Clé qui identifie tous les objets du cache créés par SqlDataSource.

Remarques

Le SqlDataSource contrôle prend en charge la mise en cache des données. Lorsque 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 les met à nouveau en cache.

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 faire expirer par programmation toutes les entrées de cache à tout moment en faisant expirer la clé.

Le SqlDataSource contrôle peut mettre en cache les données uniquement lorsqu’il DataSet est en mode . Une NotSupportedException exception est levée par la Select méthode , si le SqlDataSource contrôle est défini sur la valeur et que la DataReader mise en cache est également activée.

Une entrée de cache unique est créée pour chaque combinaison des SelectCommandpropriétés , ConnectionStringet SelectParameters . 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 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 vous attendez à ce 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.

S’applique à

Voir aussi