100% Free Forever
AI-Powered Learning
Industry Expert Content
Certificates & Badges
Learn At Your Own Pace
.NET Framework

Caching in Web Forms

Learn how output caching, fragment caching, and the Cache API reduce database and rendering load in Classic ASP.NET Web Forms applications.

Web Forms Data AccessIntermediate10 min readJul 10, 2026
Analogies

Why Cache in Web Forms?

Caching stores the result of expensive work — a database query, a rendered page fragment, a computed report — in memory so subsequent requests can reuse it instead of redoing that work from scratch. Classic Web Forms offers caching at several levels: output caching stores the fully rendered HTML of a page or user control, data caching via the Cache API stores arbitrary objects like a DataTable or a List<T>, and fragment caching applies output caching to just one user control on an otherwise dynamic page. Choosing the right level matters: caching an entire page is powerful but only works if the whole page is the same for every visitor, while data caching is more surgical, letting you reuse a slow query's result while still rendering personalized markup around it.

🏏

Cricket analogy: A broadcaster replaying a pre-recorded highlights package instead of re-filming the same six from scratch every time it airs is like output caching serving a pre-rendered page instead of regenerating it on every single request.

Output Caching

The @OutputCache directive at the top of an .aspx page (or a user control's .ascx) declares Duration in seconds and a VaryByParam setting, such as VaryByParam="none" for a single cached version or VaryByParam="categoryId" to cache a separate copy per distinct query-string value. Applying @OutputCache to a user control rather than a whole page is called fragment caching or partial-page caching, and it's done with VaryByControl or simply by placing the directive in the .ascx file, letting you cache an expensive sidebar widget (like a "trending products" list) while the rest of the page — including anything personalized to the logged-in user — still renders fresh on every request.

🏏

Cricket analogy: A pitch report graphic that's generated once before the toss and reused for the whole broadcast, rather than redrawn every over, mirrors a page with VaryByParam="none" caching a single version for a fixed duration.

aspx
<%@ OutputCache Duration="120" VaryByParam="categoryId" %>

<!-- On a user control (fragment caching) -->
<%@ Control Language="C#" AutoEventWireup="true"
    CodeBehind="TrendingWidget.ascx.cs" Inherits="MyApp.TrendingWidget" %>
<%@ OutputCache Duration="300" VaryByParam="none" %>

The Cache API (System.Web.Caching.Cache)

The Cache object, accessed via HttpContext.Current.Cache or simply Cache inside a Page, stores arbitrary .NET objects — a DataTable, a List<Product>, a lookup dictionary — keyed by string, and unlike Application state it supports automatic expiration and dependency-based invalidation. Cache.Insert(key, value, dependency, absoluteExpiration, slidingExpiration) is the most common overload: an absolute expiration removes the item after a fixed wall-clock time regardless of use, while a sliding expiration resets the countdown every time the item is accessed, evicting it only after a period of inactivity. Under memory pressure, the Cache also performs automatic scavenging, evicting lower-priority entries first, which means code reading from the Cache must always be prepared for a cache miss and fall back to reloading the data from the database.

🏏

Cricket analogy: A ground's replay system that automatically clears an old review clip from its short-term buffer once it hasn't been rewatched in a while, rather than keeping it forever, mirrors sliding expiration evicting a Cache entry after a period of inactivity.

Unlike Application state, the Cache object supports expiration policies and CacheDependency objects, and the ASP.NET runtime can evict entries automatically when the server is under memory pressure. Application state has none of this — items live for the lifetime of the app pool unless removed manually — which makes Cache the correct choice for anything that should expire or refresh.

Cache Invalidation Strategies

The hardest part of caching is knowing when to throw stale data away. A SqlCacheDependency ties a Cache entry to a specific SQL Server table or query, automatically invalidating the cached item the moment the underlying data changes, which requires enabling either SQL Server query notifications or, in older setups, polling-based dependency on a table. When a full dependency isn't practical, many teams fall back to manual invalidation: explicitly calling Cache.Remove(key) inside the same code path that performs an UPDATE or DELETE, so the next read is forced to reload fresh data. Sliding expiration is convenient for slowly-changing lookup data (like a list of countries) where staleness for a few minutes is harmless, while absolute expiration or explicit invalidation is safer for anything where users would notice or be harmed by out-of-date data, like inventory counts.

🏏

Cricket analogy: A ground staff immediately updating the electronic scoreboard the instant a wicket falls, rather than waiting for a scheduled refresh, mirrors explicit Cache.Remove() invalidation tied directly to the moment underlying data changes.

Caching a page or fragment with VaryByParam="none" that actually contains user-specific content (like an account balance or a "Welcome, [Name]") will leak one user's data to every other visitor who hits the cached version. Always verify a cached fragment is genuinely identical for every user before enabling output caching on it.

  • Caching stores expensive results (queries, computed data, rendered HTML) in memory to avoid redoing the work on every request.
  • Output caching (@OutputCache) caches fully rendered page HTML; fragment caching applies the same to a single user control.
  • VaryByParam controls whether one cached version or a separate version per distinct query-string value is stored.
  • The Cache API stores arbitrary objects with absolute or sliding expiration and automatic scavenging under memory pressure, unlike Application state.
  • SqlCacheDependency can auto-invalidate a cached item when its underlying SQL Server data changes; otherwise call Cache.Remove() manually.
  • Never output-cache a page or fragment that renders user-specific data with VaryByParam="none", or you risk leaking one user's data to another.

Practice what you learned

Was this page helpful?

Topics covered

#NETFramework#ClassicASPNETWebFormsWebPagesStudyNotes#MicrosoftTechnologies#CachingInWebForms#Caching#Web#Forms#Cache#WebDevelopment#StudyNotes#SkillVeris