Configuration du cache dans ASP.NET

Article
10/22/2014

Mise à jour : novembre 2007

ASP.NET fournit un grand nombre d'options permettant de configurer la mise en cache de sortie de page et l'API du cache. Le cache de sortie de page sert à mettre en cache les réponses de page à l'issue de leur traitement. L'API du cache sert à mettre en cache par programme les données d'application. Pour plus d'informations, consultez Vue d'ensemble de la mise en cache ASP.NET.

Configuration du cache de sortie de page

Vous pouvez configurer la mise en cache de sortie de page aux endroits suivants :

Fichiers de configuration Vous pouvez configurer les paramètres du cache de sortie de page dans n'importe quel fichier de configuration situé dans la hiérarchie de configuration de l'application, notamment le fichier Machine.config (pour définir les paramètres de l'ensemble des applications Web de votre ordinateur) et le fichier Web.config spécifique à votre application (pour définir les paramètres d'une application donnée).
Pages individuelles Vous pouvez définir des options de mise en cache dans des pages, de façon déclarative ou par programme. Vous pouvez également appliquer aux pages des profils de cache créés dans le fichier de configuration.
Contrôles utilisateur Vous pouvez définir la mise en cache dans les contrôles utilisateur de façon déclarative ou par programme. Cela permet de mettre facilement en cache le contenu d'une page qui n'est pas mis en cache par ailleurs.

Paramètres de configuration du cache dans Web.config

Il existe deux sections de configuration de niveau supérieur pour le cache de sortie de page dans le fichier Web.config : la section OutputCacheSection et la section OutputCacheSettingsSection.

La section OutputCacheSection est utilisée pour configurer les paramètres de portée application, comme l'activation de la mise en cache de la sortie de page. Par exemple, vous pouvez désactiver la mise en cache de la sortie de page pour la totalité de l'application entière en ajoutant enableOutputCache="false" à l'objet OutputCacheSection dans votre fichier Web.config. Les paramètres du fichier de configuration sont prioritaires sur les paramètres de cache des pages individuelles ; en conséquence, le paramètre défini dans l'exemple signifie que le cache de sortie ne sera pas utilisé.

La section OutputCacheSettingsSection est utilisée pour configurer les profils et les dépendances qui peuvent être utilisées par les pages. Par exemple, le code suivant crée OutputCacheProfile nommé CacheProfile1 qui mettra en cache pendant 60 secondes la page d'implémentation :

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="CacheProfile1" duration="60" />
  </outputCacheProfiles>
</outputCacheSettings>

Paramètres de configuration du cache dans Machine.config

Les sections de configuration du fichier Machine.config sont les mêmes que celles du fichier Web.config, excepté que vous pouvez verrouiller les paramètres de configuration du fichier Machine.config afin qu'ils ne puissent pas être substitués par les applications, à quelque niveau que ce soit. Cela peut être nécessaire dans un scénario d'hébergement partagé dans lequel l'hôte ne souhaite pas que les applications modifient la configuration du cache. Pour plus d'informations, consultez Comment : verrouiller des paramètres de configuration ASP.NET.

Paramètres de configuration du cache de page

Vous pouvez configurer la mise en cache dans des pages individuelles en appliquant des profils de cache définis dans un fichier de configuration. Vous pouvez aussi configurer des propriétés de cache individuelles, soit dans la directive @ OutputCache, soit en définissant des attributs dans la définition de classe de la page. Pour plus d'informations, consultez @ OutputCache et Définition de la capacité d'une page à être mise en cache.

Paramètres de configuration du cache de contrôle utilisateur

Vous pouvez configurer la mise en cache des contrôles utilisateur en définissant la directive @ OutputCache dans le fichier de contrôle utilisateur ou en définissant l'attribut PartialCachingAttribute dans la définition de classe du contrôle. Pour plus d'informations, consultez Mise en cache de parties d'une page ASP.NET.

Paramètres de configuration de l'API du cache

Vous pouvez configurer l'API du cache de l'application dans votre fichier Web.config. Comme avec le cache de sortie de page, les hôtes des applications peuvent définir des propriétés de configuration dans le fichier Machine.config et verrouiller les paramètres de configuration du cache pour toutes les applications. L'API du cache de l'application est configurée dans la section CacheSection. Par exemple, vous pouvez désactiver l'expiration des éléments grâce à l'élément de configuration suivant :

Vous pouvez également spécifier d'autres paramètres de configuration de l'API du cache de l'application en assignant des valeurs aux attributs, comme DisableExpiration et DisableMemoryCollection dans la section CacheSection du fichier de configuration.