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 default [String^] {
	bool get (String^ header);
	void set (String^ header, bool value);
}
/** @property */
public boolean get_Item (String header)

/** @property */
public void set_Item (String header, boolean value)

Not applicable.

Parameters

header

The name of the custom header.

Property Value

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

Exception typeCondition

ArgumentNullException

header is a null reference (Nothing in Visual Basic).

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).

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: