HttpCacheVaryByHeaders Class

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.

Provides a type-safe way to set the VaryByHeaders property.

public ref class HttpCacheVaryByHeaders sealed

public sealed class HttpCacheVaryByHeaders

type HttpCacheVaryByHeaders = class

Public NotInheritable Class HttpCacheVaryByHeaders

Inheritance: Object
HttpCacheVaryByHeaders

Remarks

The VaryByHeaders property identifies which request header parameters ASP.NET uses to uniquely identify a variation of the response when there are multiple cached responses for a resource. This is useful when a response depends on a set of client inputs, such as headers or parameters.

The HttpCacheVaryByHeaders is not directly related to HTTP cache-control headers, but helps ensure that a client or proxy varies by the specified headers. For more information about VaryByHeaders, 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.

Constructors

HttpCacheVaryByHeaders()

Initializes a new instance of the HttpCacheVaryByHeaders class.

Properties

AcceptTypes	Gets or sets a value indicating whether the ASP.NET output cache varies the cached responses by the `Accept` HTTP header, and appends it to the out-going `Vary` HTTP header.
Item[String]	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.
UserAgent	Gets or sets a value indicating whether the ASP.NET output cache varies the cached responses by the `User-Agent` header, and appends it to the out-going `Vary` HTTP header.
UserCharSet	Gets or sets a value indicating whether the ASP.NET output cache varies the cached responses by the `Accept-Charset` header, and appends it to the out-going `Vary` HTTP header.
UserLanguage	Gets or sets a value indicating whether the ASP.NET output cache varies the cached responses by the `Accept-Language` header, and appends it to the out-going `Vary` HTTP header.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetHeaders()	Gets an array of values which specify the HTTP headers to be used for varying the cache.
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
SetHeaders(String[])	Sets an array of values which specify the HTTP headers to be used for varying the cache.
ToString()	Returns a string that represents the current object. (Inherited from Object)
VaryByUnspecifiedParameters()	Causes ASP.NET to vary by all header values and sets the `Vary` HTTP header to the value * (an asterisk). All other `Vary` header information to be dropped.

Applies to

مشاركة عبر