Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

SqlDataSource.EnableCaching, propriété

Obtient ou définit une valeur indiquant si la mise en cache de données du contrôle SqlDataSource est activée.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

public virtual bool EnableCaching { get; set; }
<asp:SqlDataSource EnableCaching="True|False" />

Valeur de propriété

Type : System.Boolean
true si la mise en cache est activée pour le contrôle de source de données ; sinon, false. La valeur par défaut est false.

ExceptionCondition
NotSupportedException

La propriété EnableCaching a la valeur true lorsque la mise en cache n'est pas prise en charge par SqlDataSource.

Le contrôle SqlDataSource prend en charge la mise en cache. Tant que les données sont mises en cache, la méthode Select récupère les données du cache plutôt que celles de la base de données sous-jacente. Lorsque le cache expire, la méthode Select récupère les données de la base de données sous-jacente, puis remet les données en cache.

Le contrôle SqlDataSource met automatiquement les données en cache lorsque la propriété EnableCaching a la valeur true et lorsque la valeur de la propriété CacheDuration est supérieure à 0, indiquant le nombre de secondes pendant lesquelles le cache stocke les données avant de récupérer un jeu actualisé.

Note de sécuritéNote de sécurité

Lorsque vous utilisez l'emprunt d'identité du client dans le cadre de 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, elles 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 prévoyez que plusieurs utilisateurs accèdent aux données et souhaitez que chaque récupération de 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.

L'exemple de code suivant illustre comment récupérer des données de la base de données Northwind dans Microsoft SQL Server et les afficher dans un contrôle GridView, avec la mise en cache de données activée. La propriété EnableCaching a la valeur true et CacheDuration a la valeur de 20 secondes. Étant donné que le champ Absolute est affecté par défaut à la propriété CacheExpirationPolicy, les utilisateurs de cette page consulteront des données actualisées toutes les 20 secondes.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                DataSourceMode="DataSet"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                EnableCaching="True"
                CacheDuration="20"
                SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees">
            </asp:SqlDataSource>

            <asp:GridView
                id="GridView1"
                runat="server"
                AutoGenerateColumns="False"
                DataSourceID="SqlDataSource1">
                <columns>
                    <asp:BoundField HeaderText="First Name" DataField="FirstName" />
                    <asp:BoundField HeaderText="Last Name" DataField="LastName" />
                    <asp:BoundField HeaderText="Title" DataField="Title" />
                </columns>
            </asp:GridView>

        </form>
    </body>
</html>


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft