WebResponse.Headers Property

When overridden in a derived class, gets a collection of header name-value pairs associated with this request.

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

public virtual WebHeaderCollection Headers { get; }

Property Value

Type: System.Net.WebHeaderCollection
An instance of the WebHeaderCollection class that contains header values associated with this response.


Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

The Headers property contains the name-value header pairs returned in the response.


The WebResponse class is an abstract class. The actual behavior of WebResponse instances at run time is determined by the descendant class. For more information about default values and exceptions, please see the documentation for the HttpWebResponse descendant class.

The Headers property is supported by the client HTTP stack, not the browser HTTP stack. The NotImplementedException is thrown if an application does not use the client HTTP stack for the HTTP response and tries to get the Headers property in the descendant class. The SupportsHeaders property can be used to determine if the Headers property is supported without the need to handle an exception.

By default, the browser HTTP stack is used by the HttpWebRequest and the HttpWebResponse class. An application can use the client HTTP stack by calling the RegisterPrefix method with the creator parameter set to the value returned by the ClientHttp property.

If an application implements a custom WebResponse class and does not override the Headers property, then the NotImplementedException is thrown.


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.