WebResponse.Headers Property

July 28, 2014

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.

ExceptionCondition
NotImplementedException

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.

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.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft