Exporter (0) Imprimer
Développer tout

Comment : mettre en cache des versions d'une page à l'aide de chaînes personnalisées

Mise à jour : novembre 2007

En plus de varier le cache de sortie en fonction du type de navigateur et de paramètres, vous pouvez mettre en cache plusieurs versions d'une sortie de page en fonction de différentes chaînes retournées par une méthode que vous définissez.

Lorsque vous mettez en cache des pages en fonction de chaînes personnalisées, vous spécifiez d'abord un identificateur pour la chaîne personnalisée à utiliser. Vous créez ensuite une méthode dans le fichier Global.asax de l'application qui accepte l'identificateur et retourne une valeur en fonction de laquelle le cache de sortie est varié.

Pour mettre en cache plusieurs versions d'une sortie de page en fonction de chaînes personnalisées

  1. Dans la page ASP.NET, incluez une directive @ OutputCache avec les attributs Duration et VaryByParam requis. L'attribut Duration doit avoir une valeur de type entier supérieure à zéro. Si vous ne souhaitez pas utiliser la fonctionnalité proposée par l'attribut VaryByParam, assignez-lui la valeur "None".

  2. Pour définir la chaîne personnalisée de manière déclarative, dans la directive @ OutputCache, incluez l'attribut VaryByCustom ayant comme valeur la chaîne en fonction de laquelle vous voulez faire varier le cache de sortie.

    La directive suivante fait varier la sortie de la page en fonction de la chaîne personnalisée "minorversion".

    <%@ OutputCache Duration="10" VaryByParam="None" VaryByCustom="minorversion" %>
    
  3. Pour définir la chaîne personnalisée par programme, appelez la méthode SetVaryByCustom et passez-lui la chaîne personnalisée à utiliser.

    L'exemple de code suivant montre comment définir la chaîne personnalisée "minorversion".

    Response.Cache.SetVaryByCustom("minorversion");
    

    Response.Cache.SetVaryByCustom("minorversion")
    
    5ecf4420.alert_note(fr-fr,VS.100).gifRemarque :

    Si vous essayez de définir la chaîne personnalisée à la fois par programme et de façon déclarative, vous obtiendrez une InvalidOperationException. Vous devez choisir l'une des deux approches.

  4. Dans le fichier Global.asax de l'application, substituez la méthode GetVaryByCustomString afin de spécifier le comportement du cache de sortie pour la chaîne personnalisée.

    Comme son paramètre arg, la méthode substituée accepte la chaîne que vous définissez dans l'attribut VaryByCustom ou dans la méthode SetVaryByCustom. Par exemple, vous pouvez avoir des pages qui sont mises en cache en fonction de la version secondaire du navigateur qui effectue la demande. Pour ces pages, vous pouvez affecter la valeur "minorversion" à l'attribut VaryByCustom. Puis, dans la méthode GetVaryByCustomString substituée, vous pouvez vérifier le paramètre arg et retourner des chaînes différentes si la valeur du paramètre arg est "minorversion".

    L'exemple de code suivant présente un fichier Global.asax avec une substitution de la méthode GetVaryByCustomString.

    <%@ Application language="C#" %>
    <script runat="server">
    public override string GetVaryByCustomString(HttpContext context, 
        string arg)
    {
        if(arg == "minorversion")
        {
            return "Version=" +
                context.Request.Browser.MinorVersion.ToString();
        }
        return base.GetVaryByCustomString(context, arg);
    }
    </script>
    

    <script runat="server">
    Public Overrides Function GetVaryByCustomString(context _
            As HttpContext, arg As String) As String
        If (arg = "minorversion") Then
            Return "Version=" & _
                context.Request.Browser.MinorVersion.ToString()
        return base.GetVaryByCustomString(context, arg);
    End Function
    </script>
    

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft