AnonymousIdentificationSection.CookieRequireSSL Property

Reference

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value indicating whether a Secure Sockets Layer (SSL) connection is required when transmitting authentication information.

public:
 property bool CookieRequireSSL { bool get(); void set(bool value); };

[System.Configuration.ConfigurationProperty("cookieRequireSSL", DefaultValue=false)]
public bool CookieRequireSSL { get; set; }

[<System.Configuration.ConfigurationProperty("cookieRequireSSL", DefaultValue=false)>]
member this.CookieRequireSSL : bool with get, set

Public Property CookieRequireSSL As Boolean

Property Value

Boolean

true if an SSL connection is required; otherwise, false. The default is false.

Attributes: ConfigurationPropertyAttribute

Examples

The following code example shows how to access the CookieRequireSSL property.

// Get CookieRequireSSL.
bool cookieRequireSSL = 
    anonymousIdentificationSection.CookieRequireSSL;
Console.WriteLine("Cookie require SSL: {0}", 
    cookieRequireSSL.ToString());

' Get CookieRequireSSL.
Dim cookieRequireSSL As Boolean = _
anonymousIdentificationSection.CookieRequireSSL
Console.WriteLine("Cookie require SSL: {0}", _
cookieRequireSSL.ToString())

Remarks

If CookieRequireSSL is true, a compliant browser does not return the cookie unless the connection is over SSL.

Note

When the anonymous identifier is stored within the URI path, rather than in a cookie, the CookieRequireSSL setting does not affect the behavior of the anonymous identification module. This is consistent with the behavior in forms authentication.

Applies to

Jaa