Skip to content

Clarify OutputCache intent and limitations for classic ASP.Net.#54828

Open
StephenMolloy wants to merge 1 commit into
dotnet:mainfrom
StephenMolloy:outputcache-positioning-update
Open

Clarify OutputCache intent and limitations for classic ASP.Net.#54828
StephenMolloy wants to merge 1 commit into
dotnet:mainfrom
StephenMolloy:outputcache-positioning-update

Conversation

@StephenMolloy

@StephenMolloy StephenMolloy commented Jul 17, 2026

Copy link
Copy Markdown
Member

This pull request improves the documentation for output caching in .NET Framework applications by clarifying how cache variation settings like VaryByParam and VaryByHeader work, and by adding important guidance about not relying on cache variation for isolating sensitive content. The updates emphasize that output caching is a performance optimization and that isolation for personalized or sensitive responses must be enforced separately.

Clarification and guidance on output caching:


Internal previews

📄 File 🔗 Preview link
docs/framework/performance/caching-in-net-framework-applications.md docs/framework/performance/caching-in-net-framework-applications
docs/framework/wcf/feature-details/caching-support-for-wcf-web-http-services.md docs/framework/wcf/feature-details/caching-support-for-wcf-web-http-services
docs/framework/wcf/samples/aspnet-caching-integration.md docs/framework/wcf/samples/aspnet-caching-integration

Copilot AI review requested due to automatic review settings July 17, 2026 18:50
@StephenMolloy
StephenMolloy requested a review from a team as a code owner July 17, 2026 18:50
@dotnetrepoman dotnetrepoman Bot added this to the July 2026 milestone Jul 17, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request clarifies how ASP.NET output caching variation works in .NET Framework scenarios, and adds consistent guidance that cache variation is for performance—not for isolating sensitive or personalized responses.

Changes:

  • Expanded output caching explanation, including how VaryBy* settings influence cached representations.
  • Added consistent IMPORTANT warnings across relevant docs that cache variation doesn’t enforce security or isolation boundaries.
  • Updated the WCF + ASP.NET output caching integration sample documentation to include the same guidance.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/framework/wcf/samples/aspnet-caching-integration.md Adds an IMPORTANT warning about not using cache variation to isolate sensitive or personalized content.
docs/framework/wcf/feature-details/caching-support-for-wcf-web-http-services.md Adds the same IMPORTANT warning; also contains a minor attribute-name inconsistency called out in review comments.
docs/framework/performance/caching-in-net-framework-applications.md Expands the “Output Caching” section with explanation of alternate representations and adds an IMPORTANT warning about isolation limitations.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants