WebResponse.Headers Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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)

Syntax

'Declaration
Public Overridable ReadOnly Property Headers As WebHeaderCollection
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.

Exceptions

Exception Condition
NotImplementedException

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

Remarks

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

NoteNote:

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.

Version Information

Silverlight

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

Platforms

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