HttpCacheVaryByHeaders.UserAgent Property


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.

 property bool UserAgent { bool get(); void set(bool value); };
public bool UserAgent { get; set; }
member this.UserAgent : bool with get, set
Public Property UserAgent As Boolean

Property Value

true when the ASP.NET output cache varies by the User-Agent header, and adds it to the Vary HTTP header sent to the client; otherwise, false. The default value is false.


The following code example demonstrates how some action is performed only if the UserAgent property is true.

Response.Cache.VaryByHeaders.UserAgent = true;
Response.Cache.VaryByHeaders.UserAgent = True


The Vary header indicates the request-header fields that the server uses to determine which of multiple cached responses is sent in response to a client request. The User-Agent field specifies that the server selects the response based on the client's user-agent type.

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.

Applies to