Login.RememberMeSet Property
Definition
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 to send a persistent authentication cookie to the user's browser.
public:
virtual property bool RememberMeSet { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool RememberMeSet { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.RememberMeSet : bool with get, set
Public Overridable Property RememberMeSet As Boolean
Property Value
true
to send a persistent authentication cookie; otherwise, false
. The default value is false
.
- Attributes
Remarks
When the RememberMeSet property is true
, the authentication cookie sent to the user's computer is set to expire in 50 years, making it a persistent cookie that will be used when the user next visits the Web site. Because the authentication cookie will be present on the user's computer, the user will be considered already authenticated and will not have to log in to the Web site again.
When the DisplayRememberMe property is true
, the RememberMeSet property is set to the value of the check box displayed to the user.
If the DisplayRememberMe property is false
, a Remember Me check box is not displayed on the page and the user has no way to control whether the authentication cookie is persistent. If the RememberMeSet property is true
, the authentication cookie sent to the user's browser will be a persistent cookie.
If the user logs out of the Web site using the LoginStatus control, the persistent cookie is cleared from the user's computer and the user will have to log in to the site on the next visit.
Note
There are inherent security risks with setting a persistent authentication cookie on a user's browser. You should determine whether these security risks are acceptable to your site. If you set the RememberMeSet property to true
and the DisplayRememberMe property to false
, users visiting your Web site from public browsers, as in Internet cafes for example, can accidentally leave persistent authentication cookies behind and the next user of the browser will be able to access your Web site using the previous user's credentials.
This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and ASP.NET Themes and Skins.