HttpCachePolicy.SetVaryByCustom Method (String)

 

Specifies a custom text string to vary cached output responses by.

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

Public Sub SetVaryByCustom (
	custom As String
)

Parameters

custom
Type: System.String

The text string to vary cached output by.

Exception Condition
ArgumentNullException

custom is null.

InvalidOperationException

The SetVaryByCustom method has already been called.

SetVaryByCustom is introduced in the .NET Framework version 3.5. For more information, see .NET Framework Versions and Dependencies.

The following code example demonstrates how to set the custom vary string to "Accept-Charset", which causes the origin-server's cache to choose one of several cached responses depending on the browser's Accept-Charset header.

Response.Cache.SetVaryByCustom("Accept-Charset")

.NET Framework
Available since 1.1
Return to top
Show: