Comment : définir la capacité de mise en cache d'une page ASP.NET de manière déclarative

Article
10/22/2014

Mise à jour : novembre 2007

La capacité de mise en cache d'une page ou d'un contrôle utilisateur fait référence à la possibilité de mettre une page en cache sur un système pendant le cycle de vie de réponse de la page. Ces systèmes incluent le client (navigateur) qui émet la demande, le serveur Web qui y répond, ainsi que les systèmes prenant en charge la mise en cache, tels que des serveurs proxy, situés dans le flux de demande ou de réponse.

Si vous connaissez au moment du design le paramètre de mise en cache dont vous avez besoin pour une page, vous pouvez définir la capacité de mise en cache de façon déclarative. La page utilise ensuite les mêmes paramètres de capacité de mise en cache pour toutes les demandes. Pour plus d'informations, consultez Définition de la capacité d'une page à être mise en cache.

Pour définir de façon déclarative la capacité d'une page à être mise en cache

Incluez une directive @ OutputCache dans la page et définissez les attributs Duration et VaryByParam.

Incluez un attribut Location dans la directive @ OutputCache et affectez-lui l'une des valeurs suivantes dans l'énumération OutputCacheLocation : Any, Client, Downstream, Server, ServerAndClient ou None.

Le code suivant montre comment définir une durée de 60 secondes pour la capacité de mise en cache de la page :

<%@ OutputCache Duration="60" VaryByParam="None"%>

Remarque :
Le paramètre par défaut est Any. Si vous ne définissez pas d'attribut Location, la sortie de la page peut être mise en cache sur tous les systèmes réseau participant au processus de réponse et prenant en charge cette fonctionnalité. Ils comprennent le client demandeur, le serveur d'origine et tous les serveurs proxy par lesquels passe la réponse.

Pour définir de façon déclarative la capacité de mise en cache d'une page à l'aide d'un profil de cache

Définissez un profil de cache dans le fichier Web.config de votre application et dans le profil, incluez les paramètres duration et varyByParam.

L'élément de configuration < caching > suivant définit un profil de cache nommé Cache30Seconds qui met la page en cache sur le serveur pendant 30 secondes.
```
<caching>
  <outputCacheSettings>
    <outputCacheProfiles>
      <add name="Cache30Seconds" duration="30" 
        varyByParam="none" />
    </outputCacheProfiles>
  </outputCacheSettings>
</caching>
```
Incluez une directive @ OutputCache dans chaque page ASP.NET qui utilise le profil et affectez à l'attribut CacheProfile le nom du profil de cache défini dans votre fichier Web.config.

Le code suivant spécifie que la page doit utiliser le profil de cache nommé Cache30Seconds :
```
<%@ OutputCache CacheProfile="Cache30Seconds" %>
```

Voir aussi

Tâches

Comment : définir la capacité de mise en cache d'une page par programme

Concepts

Mise en cache de pages ASP.NET

Définition de la capacité d'une page à être mise en cache

Partager via