Share via


How to: Cache Versions of a Page Using Parameters

There are times when you want to cache a page, but the page might generate different output based on the value of a query string parameter or values sent with the page on postback. For example, if you have a page that shows locations of stores based on a user's state, the page might accept a "state" query string value that generates a different version of the page for each state.

You can cache multiple versions of page responses based on the parameters sent as query string values or form post values.

Note

ASP.NET treats query string values or form post values with identical key/value pairs as identical for caching purposes, regardless of the order in which the parameters are passed. However, for caching purposes, parameter names are case-sensitive and ASP.NET will cache different versions of a page for uppercase and lowercase parameter names and values.

To cache multiple versions of page output declaratively using parameters

  1. In the ASP.NET page, include an @ OutputCache directive with a Duration attribute. The Duration attribute is required and must be set to an integer greater than zero.

  2. In the @ OutputCache directive, include a VaryByParam attribute and set its value to the name of the query string or form post parameter that you want to vary the page by.

    The following code example caches the page for 60 seconds and specifies that different versions of the page output will be cached based on the City query string value or form post parameter.

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

    Note

    If you want to vary the output cache by multiple parameters, include a list of parameter names separated by semicolons (;). If you want to vary the cache by all parameter values, set the VaryByParam attribute to an asterisk (*). The following code example shows how to vary the page output by City and ZipCode parameters.

    <%@ OutputCache Duration="60" VaryByParam="City;ZipCode" %>
    

To cache multiple versions of page output programmatically using parameters

  1. In the page's Page_Load event, call the SetCacheability and SetExpires methods on the Cache property of the Response object.

  2. Specify the parameter name as the argument for the Response object's VaryByParams property, and set the property to true.

    The following code example shows how to cache multiple versions of a page when requests arrive at the server with different values for the Zip parameter.

    Response.Cache.SetExpires(DateTime.Now.AddMinutes(1.0));
    Response.Cache.SetCacheability(HttpCacheability.Public);
    Response.Cache.SetValidUntilExpires(true);
    Response.Cache.VaryByParams["Zip"] = true;
    
    Response.Cache.SetExpires(DateTime.Now.AddMinutes(1.0))
    Response.Cache.SetCacheability(HttpCacheability.Public)
    Response.Cache.SetValidUntilExpires(True)
    Response.Cache.VaryByParams("Zip") = True
    

    Note

    If you want to vary the cached content by multiple parameters, set the VaryByParams property multiple times. If you want to vary the cached content by all header values, set the VaryByHeader attribute to an asterisk (*). The following code example shows how to vary the page output by City and Zip parameters.

    Response.Cache.SetExpires(DateTime.Now.AddMinutes(1.0));
    Response.Cache.SetCacheability(HttpCacheability.Public);
    Response.Cache.SetValidUntilExpires(true);
    Response.Cache.VaryByParams["City"] = true;
    Response.Cache.VaryByParams["Zip"] = true;
    
    Response.Cache.SetExpires(DateTime.Now.AddMinutes(1.0))
    Response.Cache.SetCacheability(HttpCacheability.Public)
    Response.Cache.SetValidUntilExpires(True)
    Response.Cache.VaryByParams("City") = true
    Response.Cache.VaryByParams("Zip") = true
    

See Also

Tasks

How to: Set the Cacheability of an ASP.NET Page Declaratively

How to: Set a Page's Cacheability Programmatically

How to: Cache Versions of a Page Using Requesting Browser

How to: Cache Versions of a Page Using HTTP Headers

How to: Cache Versions of a Page Using Custom Strings

Concepts

Caching ASP.NET Pages

Setting the Cacheability of a Page

Caching Multiple Versions of a Page