HttpWebRequest.SupportsCookieContainer Property

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

Gets a value that indicates whether the CookieContainer property is supported by the HttpWebRequest instance.

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

Syntax

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

Property Value

Type: System.Boolean
true if the CookieContainer property is supported by the HttpWebRequest instance; otherwise, false.

Remarks

The CookieContainer 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 request and tries to get or set the CookieContainer property. The SupportsCookieContainer property can be used to determine if the CookieContainer property is supported without the need to handle an exception.

By default, the browser HTTP stack is used by the HttpWebRequest 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 WebRequest class and does not override the CookieContainer property, then the NotImplementedException is thrown.

Version 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.