This documentation is archived and is not being maintained.

HttpCacheVaryByHeaders::Item Property

Gets or sets a custom header field that the ASP.NET output cache varies the cached responses by, and appends it to the out-going Vary HTTP header.

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

public:
property bool Item[String^ header] {
	bool get (String^ header);
	void set (String^ header, bool value);
}

Parameters

header
Type: System::String
The name of the custom header.

Property Value

Type: System::Boolean
true when the ASP.NET output cache varies by the specified custom field; otherwise, false. The default value is false.

ExceptionCondition
ArgumentNullException

header is nullptr.

The Vary header indicates the request-header fields that the server varies the response by.

For more information, see RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1, available on the World Wide Web Consortium (W3C) Web site. See section 14, "Header Field Definitions", for complete details.

The VaryByUnspecifiedParameters method is called internally if the specified header has the value * (an asterisk).

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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