Caching in ASP.NET

原创 2004年07月05日 00:13:00


The majority [if not all] of the pages in a dynamic website are dynamic. That is, pages that are created on user request. As we all know, dynamic web pages help to provide dynamic content, customized for the user requesting the page [e.g.: the user's home page]. Dynamic pages also help provide dynamic content fetched from a changing data store without the need for the administrator to change the page content every time something changes in the data store [e.g.: Listing of books in a publisher's website]. The disadvantage is the overhead in creating the pages for every user request.

To overcome this, some websites have page creation engines which create all pages in one go and save them as HTML pages which are then served to the users. But this will only help in scenarios where the page content is the same for all requests [user-independent] as in the second example above. The listing of books is the same irrespective of the user requesting the page. Even if there is provision for listing books category wise by providing different category ID values through the querystring, the page output for a particular category of books is the same for all users.

ASP.NET provides support for "caching" which will help us solve this problem to a great extend. It can cache [store in memory] the output generated by a page and will serve this cached content for future requests. And this is useful only in the second scenario described earlier, where the page content is the same for all requests [user-independent]. The caching feature is customizable in various ways and we will see how we can do that as we go through this article.

Caching a page

In order to cache a page's output, we need to specify an @OutputCache directive at the top of the page. The syntax is as shown below:


As you can see, there are two attributes to this directive. They are:

  • Duration - The time in seconds of how long the output should be cached. After the specified duration has elapsed, the cached output will be removed and page content generated for the next request. That output will again be cached for 10 seconds and the process repeats.
  • VaryByParam - This attribute is compulsory and specifies the querystring parameters to vary the cache.

    In the above snippet, we have specified the VaryByParam attribute as None which means the page content to be served is the same regardless of the parameters passed through the querystring [see Example 1 in the sample download].

    If there are two requests to the same page with varying querystring parameters, e.g.: .../PageCachingByParam.aspx?id=12 and .../PageCachingByParam.aspx?id=15] and separate page content is generated for each of them, the directive should be:


    The page content for the two requests will each be cached for the time specified by the Duration attribute [see Example 2 in the sample download].

    To specify multiple parameters, use semicolon to separate the parameter names. If we specify the VaryByParam attribute as *, the cached content is varied for all parameters passed through the querystring.

Some pages generate different content for different browsers. In such cases, there is provision to vary the cached output for different browsers. The @OutputCache directive has to be modified to:


This will vary the cached output not only for the browser but also its major version. I.e., IE5, IE 6, Netscape 4, Netscape 6 will all get different cached versions of the output.

Caching page fragments

Sometimes we might want to cache just portions of a page. For example, we might have a header for our page which will have the same content for all users. There might be some text/image in the header which might change everyday. In that case, we will want to cache this header for a duration of a day.

The solution is to put the header contents into a user control and then specify that the user control content should be cached. This technique is called fragment caching.

To specify that a user control should be cached, we use the @OutputCache directive just like we used it for the page.


With the above directive, the user control content will be cached for the time specified by the Duration attribute [10 secs]. Regardless of the querystring parameters and browser type and/or version, the same cached output is served. [See Example 3 in the download for a demonstration].

Data Caching

ASP.NET also supports caching of data as objects. We can store objects in memory and use them across various pages in our application. This feature is implemented using the Cache class. This cache has a lifetime equivalent to that of the application. Objects can be stored as name value pairs in the cache. A string value can be inserted into the cache as follows:


The stored string value can be retrieved like this:

if (Cache["name"] != null) Label1.Text= Cache["name"].ToString();

[See example 4 for an illustration.]

To insert objects into the cache, the Add method or different versions of the Insert method of the Cache class can be used. These methods allow us to use the more powerful features provided by the Cache class. One of the overloads of the Insert method is used as follows:

Cache.Insert("Name", strName, new CacheDependency(Server.MapPath("name.txt"), DateTime.Now.AddMinutes(2), TimeSpan.Zero);

The first two parameters are the key and the object to be inserted. The third parameter is of type CacheDependency and helps us set a dependency of this value to the file named name.txt. So whenever this file changes, the value in the cache is removed. We can specify null to indicate no dependency. The fourth parameter specifies the time at which the value should be removed from cache. [See example 5 for an illustration.] The last parameter is the sliding expiration parameter which shows the time interval after which the item is to be removed from the cache after its last accessed time.

The cache automatically removes the least used items from memory, when system memory becomes low. This process is called scavenging. We can specify priority values for items we add to the cache so that some items are given more priority than others:

Cache.Insert("Name", strName, new CacheDependency(Server.MapPath("name.txt"), DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, null);

The CacheItemPriority enumeration has members to set various priority values. The CacheItemPriority.High assigns a priority level to an item so that the item is least likely to be deleted from the cache.

Points of interest

  • If there are old ASP pages in your website which use the Response.Expires property to cache page output, they can be retained as such. ASP.NET supports this property as well.
  • The Insert method of the Cache class will overwrite any existing item with the same key name.
  • The CacheItemPriority.NotRemovable priority value can be used with Cache.Insert method to set the priority level of an item so that the item will not be removed from the cache during scavenging.


In this article, I have tried to provide an overview of the various options available for caching in ASP.NET. Elaborate explanations and details have not been provided to keep the article short.

Fragment caching can be done in a nested fashion with child controls having caching enabled. How to do this has not been covered as I have not tried it out myself. So also various overloads of the Insert method of the Cache class has not been discussed here. I hope this article will be a good starting point for the readers to explore into the details of a wonderful feature available in ASP.NET.


.net mvc中输出缓存的入门学习,Outputcache全面深入学习
  • kebi007
  • kebi007
  • 2017年03月01日 23:48
  • 3578

浅尝Unity 3D的Asset Bundle知识(六)-----缓存利用进阶篇

经过了缓存利用相关的理解,小生对于Unity的Asset Bundle的研究也将更加深入。今天就让我们进入关于缓存使用...
  • hfreedomx
  • hfreedomx
  • 2015年08月05日 15:10
  • 1154

HBase Block Cache的重要实现细节和In-Memory Cache的特点

每load一个block到cache时,都会检查当前cache的size是否已经超过了“警戒线”,这个“警戒线”是一个规定的当前block cache总体积占额定体积的安全比例,默认该值是0.85,即...
  • bluishglc
  • bluishglc
  • 2014年03月19日 10:24
  • 13056

Simple way to implement caching in ASP.NET Web API

另附:WebCache Class
  • Joyhen
  • Joyhen
  • 2016年04月01日 15:53
  • 757

ASP.NET MVC Caching with OutputCache

ASP.NET MVC Caching with OutputCache [原文:]
  • whereismatrix
  • whereismatrix
  • 2014年11月08日 17:45
  • 823

ASP.NET缓存技术学习入门---页面缓存(OutPut Caching)

  • xiaogug01
  • xiaogug01
  • 2011年04月26日 17:33
  • 335

ASP.NET MVC Action Filter - Caching and Compression

ASP.NET MVC Action Filter - Caching and Compression Friday, March 28, 2008 3:12 AM Kazi Manzur R...
  • manbufenglin
  • manbufenglin
  • 2011年11月16日 16:58
  • 374

ASP.NET Web API Caching with CacheCow and CacheOutput

  • Joyhen
  • Joyhen
  • 2014年08月01日 01:00
  • 2943

ASP.NET缓存技术学习入门---页面缓存(OutPut Caching)

  • lz00728
  • lz00728
  • 2012年04月21日 16:02
  • 861

【ASP.NET】ASP.NET缓存技术学习入门---页面缓存(OutPut Caching)

  • lijianhe043
  • lijianhe043
  • 2012年02月13日 21:10
  • 356
您举报文章:Caching in ASP.NET