Export (0) Print
Expand All

HttpResponse.WriteSubstitution Method

Allows insertion of response substitution blocks into the response, which allows dynamic generation of specified response regions for output cached responses.

Namespace:  System.Web
Assembly:  System.Web (in System.Web.dll)

public void WriteSubstitution(
	HttpResponseSubstitutionCallback callback
)

Parameters

callback
Type: System.Web.HttpResponseSubstitutionCallback

The method, user control, or object to substitute.

ExceptionCondition
ArgumentException

The target of the callback parameter is of type Control.

You can use the WriteSubstitution method for post-cache substitution in your output-cached pages. By passing a HttpContext object to a callback method with a prescribed HttpResponseSubstitutionCallback signature, you can replace output cached content at any given location in the page cache. To initiate the replacement, call the WriteSubstitution method, passing it the callback method, which must be thread safe and can be either of the following:

  • A static method on the container page or user control.

  • A static or instance method on another arbitrary object.

On the first request to the page, the WriteSubstitution calls the HttpResponseSubstitutionCallback delegate to produce the output. Then, it adds a substitution buffer to the response, which retains the delegate to call on future requests. Finally, it degrades client-side cacheability from public to server-only, ensuring future requests to the page re-invoke the delegate by not caching on the client.

NoteNote

Post-cache substitution is not supported for a cached user control where output caching is applied at the user control level. This is also known as fragment caching. For more information, see Caching Portions of an ASP.NET Page.

.NET Framework

Supported in: 4.6, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft