HttpCachePolicy.SetVaryByCustom(String) Method

Reference

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 void SetVaryByCustom(System::String ^ custom);

public void SetVaryByCustom (string custom);

member this.SetVaryByCustom : string -> unit

Public Sub SetVaryByCustom (custom As String)

Parameters

custom: String

The text string to vary cached output by.

Exceptions

ArgumentNullException

custom is null.

InvalidOperationException

The SetVaryByCustom(String) method has already been called.

Examples

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");

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

Remarks

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

Applies to

Jaa