ASP：Login控件(登录控件)

    Login控件是一个复合控件，它有效集成了登录验证页面中常见的用户界面元素和功能。通常情况下，Login控件会在页面中呈现3个核心元素，即用于输入用户名的文本框、用于输入密码的文本框和用于提交用户凭证的按钮。Login控件与成员资格管理功能集成，无需编写任何代码就能够实现用户登录功能。

    Login控件还具有很强的自定义扩展能力，主要包括以下几个方面：

Ю自定义获取密码页面的提示文字和超链接

ю自定义帮助页面的提示文字和超链接

ю自定义创建用户页面的提示文字和超链接

ю自定义“下次登录时记住”的CheckBox控件

Ю自定义各种提示信息和操作，如未填写用户凭证的提示、登录失败的提示、登录成功之后的操作等

[注]：默认情况下，Login控件使用Web.config配置文件中定义的成员资格提供程序。

 

Login控件的常用属性及说明

属性	说明
CreateUserText	获取或设置新用户注册页的链接文本
CreateUserUrl	获取或设置新用户注册页的URL，包含网站新用户注册页的URL
DestinationPageUrl	获取或设置在登录尝试成功时向用户显示的页面的URL。它将重写Login控件的默认行为以及在配置文件中所做的DefaultUrl设置
FailureAction	获取或设置当登录尝试失败时发生的操作
FailureText	获取或设置当登录尝试失败时显示的文本
HelpPageText	获取或设置登录帮助页链接的文本
HelpPageUrl	获取或设置登录帮助页的URL
InstructionText	获取或设置用户的登录说明文本
LoginButtonText	获取或设置Login控件的登录按钮的文本
MembershipProvider	获取或设置控件使用的成员资格数据提供程序的名称
Password	获取用户输入的密码，或设置用户登录所需的密码，默认为空。该属性既可在属性对话框中设置，也可以在后台代码中设置，密码为明文形式
PasswordLabelText	获取或设置Password文本框的标签文本
PasswordRecoveryText	获取或设置密码恢复页链接的文本
PasswordRecoveryUrl	获取或设置密码恢复页的URL
PasswordRequiredErrorMessage	获取或设置当密码字段为空时ValidationSummary控件中显示的错误信息
RemberMeSet	获取或设置一个值，该值指示是否将持久性身份验证Cookie发送到用户的浏览器
RemberMeText	获取或设置“记住我”复选框的标签文本
TitleText	获取或设置Login控件的标题
UserName	获取用户输入的用户名
UserNameLabelText	获取或设置UserName文本框的标签文本
UserNameRequiredErrorMessage	获取或设置当用户名字段为空时在ValidationSummary控件中显示的错误信息
VisibleWhenLoggedIn	获取或设置一个值，该值指示在验证用户身份后是否显示Login控件

 

[补充]：属性说明

►CreateUserText属性

    CreateUserText属性包含站点注册页的链接文本。在CreateUserUrl属性中指定注册页的URL。如果CreateUserUrl为空，则向用户显示CreateUserText中的文本，但不以链接的形式显示。如果CreateUserText属性为空，则不向用户提供注册页链接。

►FailureAction属性

    FailureAction属性定义当用户没有成功登录到网站时Login控件的行为，默认行为为重载页并显示FailureText属性的内容，以提醒用户登录失败。当FailureAction设置为RedirectToLoginPage时，用户将被重定向到Web.config文件中定义的登录项。

 

Login控件的常用事件及说明

    由于Login控件与成员资格管理功能集成，因此，可主要设置的是Login控件属性，而不必关心实现登录验证过程中的事件处理程序，这部分内容都是由Login控件自动完成的。实际上，Login控件允许开发人员自行实现登录验证过程中的事件处理程序。

事件	说明
Authenticate	验证用户的身份后出现
LoggedIn	在用户登录到网站并进行身份验证后出现
LoggingIn	在用户未进行身份验证而提交登录信息时出现
LoginError	当检测到登录错误时出现

[补充]：事件说明

►Authenticate事件

    当用户使用Login控件登录到网站时，会引发Authenticate事件。自定义身份验证方案可以使用Authenticate事件对用户进行身份验证，应该将Authenticated属性设置为true，以指示已验证用户的身份。

[注]：使用Login控件时，也可以不使用默认的成员资格提供程序，而使用Authenticate事件中编写的代码验证用户的登录信息。