WebResponse.SupportsHeaders Property

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

Gets a value that indicates whether the Headers property is supported by the descendant class for the WebResponse instance.

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

Syntax

'Declaration
Public Overridable ReadOnly Property SupportsHeaders As Boolean
public virtual bool SupportsHeaders { get; }

Property Value

Type: System.Boolean
true if the Headers property is supported by the HttpWebRequest instance in the descendant class; otherwise, false.

Remarks

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 if the property is accessed.

Platform Notes

Silverlight for Windows Phone Silverlight for Windows Phone

This member is present to support the .NET Compact Framework infrastructure in Silverlight for Windows Phone, and it is not intended to be used in your application code.

Version Information

Silverlight

Supported in: 5, 4

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.