ASP.NET关于Login控件使用

今天上网找了一些关于Login控件的使用资料，遇到一个问题：Login控件本身具有不为空的验证，就是说当用户没有输入用户名或密码的时候，直接点提交不会通过验证，会在用户名和密码的后面出现“*”，意为必须输入的项。我想，如果我不想让它显示“*”，让显示“必须填写用户名”和“必须填写密码”的提示信息。上网找了半天，就是找不到我想要达到的效果。最后还是自己研究出来了。显示“*”是Login控件本身具备的特点，所以我选择了右键控件，选择“转换为模板”，这样Login就作为几个控件合在一起的组合体。显示“*”的是RequiredFieldValidator验证控件，将它的text属性“*”，改为你想要显示的提示就行了。

另外，如果想要用ValidationSummary和Login控件合用的话，只要将其ValidationGroup属性设置为Login控件的ID就可以了。

下面是从网上转载过来的关于Login控件的一些属性和事件：

(来源：www.soAsp.net)

Login控件

1.功能
Login控件是一个复合控件，它提供对网站上的用户进行身份验证所需的，所有常见的UI元素。所有登录方案都需要以下三个元素：

● 用于标识用户的惟一用户名。

● 用于验证用户标识的密码。

● 用于将登录信息发送到服务器的登录按钮。

Login 控件还提供以下支持附加功能的可选UI 元素：

● 密码提示链接。

● 用于在两次会话之间保留登录信息的“记住我”复选框。

● 为那些在登录时遇到问题的用户提供的帮助链接。

● 将用户重定向到注册页的“注册新用户”链接。

● 出现在登录窗体上的说明文本。

● 在用户未填写用户名或密码字段而直接单击登录按钮时，出现的自定义错误文本。

● 登录失败时出现的自定义错误文本。

● 登录成功时发生的自定义操作。

● 在用户已登录到站点时隐藏登录控件的方法

2.属性
Login控件部分常用属性及说明，如表1所示。

                                表1 Login控件最常用的属性及说明

属性                                               描述

CreateUserIconUrl             获取显示在新用户的注册页链接旁边的图像的位置

CreateUserText                获取或设置新用户注册页的链接文本

CreateUserUrl                 获取或设置新用户注册页的 URL

DestinationPageUrl            获取或设置在登录尝试成功时向用户显示的页面的 URL

FailureAction                 获取或设置当登录尝试失败时发生的操作

FailureText                   获取或设置当登录尝试失败时显示的文本

HelpPageText                  获取或设置登录帮助页链接的文本

HelpPageUrl                   获取或设置登录帮助页的URL

LoginButtonText               获取或设置Login控件的登录按钮的文本

LoginButtonType               获取或设置在呈现Login按钮时使用的按钮类型

MembershipProvider            获取或设置控件使用的成员资格数据提供程序的名称

Orientatio                    获取或设置一个值，该值指定页面上Login控件的元素的位置

PasswordLabelText             获取或设置 Password文本框的标签文本

PasswordRecoveryText          获取或设置密码恢复页链接的文本

PasswordRecoveryUrl           获取或设置密码恢复页的 URL

PasswordRequiredErrorMessage 获取或设置当密码字段为空时在 ValidationSummary控件中显示的错误信息

RememberMeText                获取或设置“记住我”复选框的标签文本

TextLayout                    指定 Login 控件的每个标签相对于其关联文本框的位置

TitleText                     获取或设置Login控件的标题

UserName                      获取用户输入的用户名

UserNameLabelText             获取或设置UserName文本框的标签文本

UserNameRequiredErrorMessage 获取或设置当用户名字段为空时在ValidationSummary 控件中显示的错误信息

ValidatorTextStyle            获取对 Style 属性集合的引用，这些属性定义与Login控件使用的验证程序关联的错误信息的外观

VisibleWhenLoggedIn           获取或设置一个值，该值指示在验证用户身份后是否显示 Login 控件

下面对比较重要的属性进行详细介绍。

（1）CreateUserText属性

此属性获取或设置新用户注册页的链接文本。

语法：

public virtual string CreateUserText { get; set; }

属性值：

新用户注册页的链接文本。默认为 Empty。

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

（2）CreateUserUrl属性

此属性用来设置新用户注册页的URL，它包含网站新用户注册页的URL。

语法：

public virtual string CreateUserUrl { get; set; }

属性值：

新用户注册页的 URL。默认为 Empty。

说明：CreateUserText属性包含链接使用的文本。如果CreateUserText属性为空，则不向用户提供注册页链接。

（3）DestinationPageUrl属性

此属性获取或设置在登录尝试成功时向用户显示的页面的URL。

语法：

public virtual string DestinationPageUrl { get; set; }

属性值：

登录尝试成功时用户被重定向到的页面的 URL。默认为Empty。

例如：登录成功要转向“Default2.aspx”页面。代码如下：

Login1.DestinationPageUrl = "~/Default2.aspx";

（4）FailureAction属性

此属性获取或设置当登录尝试失败时发生的操作。

语法：

public virtual LoginFailureAction FailureAction { get; set; }

属性值：

LoginFailureAction枚举值之一。默认为Refresh。

LoginFailureAction枚举值及说明如表5所示。

                                表5 LoginFailureAction枚举值及说明

枚举值                                             说明

RedirectToLoginPage           将用户重定向到站点的配置文件（Machine.config 和 Web.config）中所定义的登录页

Refresh                       刷新当前页，以便 Login控件可以显示错误消息

（5）HelpPageUrl属性

此属性获取或设置登录帮助页的URL。

语法：

public virtual string HelpPageUrl { get; set; }

属性值：

登录帮助页的URL。默认为Empty。

    说明：HelpPageUrl 属性包含网站的登录帮助页的URL。HelpPageText属性包含用于链接的文本。如果HelpPageUrl为空，则向用户显示HelpPageText属性中的文本，但不以链接的形式显示。如果HelpPageText属性为空，则不向用户提供登录帮助页链接。

（6）HelpPageText属性

此属性获取或设置登录帮助页链接的文本

语法：

public virtual string HelpPageText { get; set; }

属性值：

登录帮助页链接的文本。默认为Empty。

（7）LoginButtonType属性

此属性获取或设置在呈现Login按钮时使用的按钮类型。

语法：

public virtual ButtonType LoginButtonType { get; set; }

属性值：

ButtonType枚举值之一。默认为Button。ButtonType枚举值及说明如表6所示。

     表6 ButtonType 枚举值及说明

枚举值          说明

Button          命令按钮

Image    显示图像的按钮

Link    超链接样式的按钮

（8）PasswordRecoveryUrl属性

此属性获取或设置密码恢复页的URL。

语法：

public virtual string PasswordRecoveryText { get; set; }

属性值：

密码恢复页链接的文本。默认为Empty。

（9）PasswordRequiredErrorMessage属性

此属性获取或设置当用户名字段为空时在ValidationSummary控件中显示的错误信息

语法：

public virtual string PasswordRequiredErrorMessage { get; set; }

属性值：

当密码字段为空时，在ValidationSummary控件中显示的错误信息。默认值是“密码”。

（10）RememberMeText 属性

此属性获取或设置“记住我”复选框的标签文本。

语法：

public virtual string RememberMeText { get; set; }

属性值：

“记住我”复选框的标签文本。默认为下“次记住我”。

（11）UserNameRequiredErrorMessag属性

获取或设置当用户名字段为空时，在ValidationSummary控件中显示的错误信息。

语法：

public virtual string UserNameRequiredErrorMessage { get; set; }

属性值：

当用户名字段为空时在ValidationSummary 控件中显示的错误信息。默认为“用户名”。

（12）VisibleWhenLoggedIn属性

此属性获取或设置一个值，该值指示在验证用户身份后是否显示Login控件。

语法：

public virtual bool VisibleWhenLoggedIn { get; set; }

属性值：

如果在验证用户身份后隐藏Login控件，则为false；否则为true。默认为true。

本例使用Login控件，实现成员资格用户登录网站验证用户名和密码。示例运行，输入用户名“mr”，密码“mr.soft”登录网站。
Login 控件设计代码如下。

<asp:Login ID="Login1" runat="server" BackColor="#F7F7DE" BorderColor="#CCCC99" BorderStyle="Solid"
            BorderWidth="1px" DestinationPageUrl="~/Default.aspx" Font-Names="Verdana" Font-Size="10pt">
            <TitleTextStyle BackColor="#6B696B" Font-Bold="True" ForeColor="#FFFFFF" />
</asp:Login>

3.事件
Login控件的常用事件及说明，如表7所示。

                                      表7 Login控件的常用事件及说明

事件                                                        描述

Authenticate       验证用户的身份后出现

LoggedIn       在用户登录到网站并进行身份验证后出现

LoggingIn       在用户未进行身份验证而提交登录信息时出现

LoginError       当检测到登录错误时出现

下面对比较重要的事件进行详细介绍。

（1）Authenticate事件

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

语法：

public event AuthenticateEventHandlerAuthenticate

    说明：在用户提交登录信息后，Login控件先引发LoggingIn事件，然后引发Authenticate事件，最后引发LoggedIn事件。

本例使用Login 控件的Authenticate事件，实现自定义用户登录网站。示例运行,输入用户名“System”，密码“111”登录网站。

代码如下。
protected void Login1_Authenticate1(object sender, AuthenticateEventArgs e)
    {
        System.Data.SqlClient.SqlConnection con = new System.Data.SqlClient.SqlConnection("server=ZHY//ZHY;uid=sa;pwd=;database=aspnetdb");
        con.Open();
        string strSql = "select * from tb_01 where userid='" + Login1.UserName.ToString() + "' and username='" + Login1.Password + "'";
        System.Data.SqlClient.SqlCommand com = new System.Data.SqlClient.SqlCommand(strSql, con);
        System.Data.SqlClient.SqlDataReader dr = com.ExecuteReader();
        if (dr.Read())
        {
            e.Authenticated = true;//通过验证
        }
        else
        {
            e.Authenticated = false;
        }
        dr.Close();
        con.Close();
    }

4.典型实例
本例实现登录控件的综合应用，使用Login控件实现成员资格用户登录网站。运行实例“Login.aspx”页，输入用户名“soAsp_net”，密码“111”登录网站。

主要代码如下。 <asp:Login ID="Login1" runat="server" BackColor="#F7F7DE" BorderColor="#CCCC99" BorderStyle="Solid" BorderWidth="1px" Font-Names="Verdana" Font-Size="10pt" DestinationPageUrl="~/Index.aspx"> <TitleTextStyle BackColor="#6B696B" Font-Bold="True" ForeColor="White" />
</asp:Login>