本文共 2105 字,大约阅读时间需要 7 分钟。
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事件中编写的代码验证用户的登录信息。
转载地址:https://blog.csdn.net/weixin_34237125/article/details/113009568 如侵犯您的版权,请留言回复原文章的地址,我们会给您删除此文章,给您带来不便请您谅解!