[转]Membership、MembershipUser和Roles类

Membership、MembershipUser和Roles类  

第一部分

用户与角色管理在asp.net2.0中是通过Membership和Roles两个类来实现的。

Membership：用户成员账号管理，用户名、密码、邮箱等

Roles：负责用户和群组之间关系管理。

l          Membership类：主要是创建用户帐号、验证用户身份和管理用户设置

属性：

1)         EnablePasswordReset：获取一个值，以指示是否可以重置密码。

2)         EnablePasswordRetrieval：获取一个值，以指示是否允许用户提取密码。

3)         HashAlgorithmType：获取一个值，密码的算法识别项

4)         MaxInvalidPasswordAttempts：获取一个值，锁定用户之间所允许的重试次数。

5)         MinRequiredNonAlphanumericCharacters：获取一个值，密码中最少的特殊字符数。

6)         MinRequiredPasswordLength：取得最小密码的长度

7)         RequiresQuestionAndAnswer：获取一个值，指示是否要求用户解答密码问题以重新提取密码。

8)         UserIsOnlineTimeWindow：指定用户最后活动日期之后的分钟数，其间的用户视为在线。

方法：

1)         CreateUser()：创建新的用户

2)         DeleteUser()：从数据库删除用户

3)         GetUser()：取得成员资格用户的信息

4)         UpdateUser()：更新用户信息

5)         ValidateUser()：验证用户账号与密码是否用效

6)         GetAllUsers()：取得数据库中用户的集合

7)         FindUsersByEmail()：根据email查询用户

8)         FinndUsersByName()：根据帐号名称查询用户

9)         GetNumberOfUsersOnline()：取得目前访问程序的在线用户

10)      GetUserNameByEmail()：根据邮箱查询用户名

l          MembershipUser类

负责管理与更新Membership表中的相关资料。别把MembershipUser类与Membership类混了，实际上是同MembershipUser处理完成后交由Membership处理。如：

1)         取得或设置用户相关信息。如UserName,Email和帐号创建时间。

2)         读取、改变用户密码

3)         改变密码提示问题与答案

4)         解锁帐号

5)         设置是否允许用户能够被验证

属性：

1)         CreationDate：取得用户的创建时间

2)         Email：取得或设置用户的电子邮件地址

3)         IsApproved：取得或设置用户是否可以进行验证

4)         IsLockedOut：取出用户是否被锁定

5)         IsOnLine：指出用户目前是否在线

6)         LastActivityDate：取得或设置用户最后一次验证或访问程序的日期时间

7)         LastLoclkoutDate：取是最近锁定用户的日期和时间

8)         LastLoginDate：取得或设置用户上一次验证的日期时间

9)         LastPasswordChangedDate：取得用户密码上一次更新的时间

10)      PasswordQuestion：取得用户的安全密码的问题

11)      UserName：取得用户登录的名称

方法：

12)      ChangePassword()：更改用户密码

13)      ChangePasswordQuestionAndAnswer：更改用户的密码安全问题和解答

14)      GetPassword()：取得用户密码

15)      ResetPassword()：将用户的密码重置，并自动产生新密码

16)      UnlockUser()：解除帐号锁定，以便能进行身份验证


l          Roles类

方法：

1)         AddUsersToRole()：将多个用户加入一个角色

2)         AddUsersToRoles()：将多个用户加入多个角色

3)         AddUserToRole()：将一个用户加入一个角色

4)         AddUserToRoles()：将一个用户加入多个角色

5)         CreateRole()：创建角色

6)         DeleteRole()：删除角色

7)         FindUsersInRole()：寻找某个角色中的所有用户

8)         GetAllRoles()：取得所有角色的清单

9)         GetRolesForUser()：取得用户所属角色的清单

10)      IsUserInRole()：指出用户是否在指定的角色中

11)      RemoveUserFromRole()：从一个角色中移除一个用户

12)      RemoveUserFromRoles()：从多个角色中移出一个用户

13)      RemoveUsersFromRole()：从一个角色中移除多个用户

14)      RemoveUsersFromRoles()：从多个角色中移除多个用户名

15)      RoleExists()：用户角色名是否已存在于角色表中。

代码实现(1)
创建用户：

MembershipCreateStatus mc;

Membership.CreateUser(txtUid.Text, txtPwd.Text, txtEmail.Text, txtQuestion.Text, txtAnswer.Text, true, out mc);

Response.Write(mc.ToString());

删除用户：

if (Membership.DeleteUser(txtUid.Text))

     Response.Write("OK");

else

Response.Write("Error");

修改用户信息：

if (User.Identity.IsAuthenticated)

{

     MembershipUser user = Membership.GetUser();

     user.Email = txtEmail.Text;

     Membership.UpdateUser(user);

     Response.Write(user.Email.ToString());

}

验证用户登录信息

bool isok = Membership.ValidateUser(txtUid.Text, txtPwd.Text);
if (isok)
{
     FormsAuthentication.SetAuthCookie(txtUid.Text, false);
     Response.Write("OK");
}
else
{
     Response.Write("Error");
}

获取登录用户的信息

if (User.Identity.IsAuthenticated)

{
     MembershipUser myuser = Membership.GetUser();

     if (myuser != null)

     {

　Response.Write(myuser.CreationDate);

　Response.Write(myuser.Email);

　Response.Write(myuser.IsLockedOut);

　Response.Write(myuser.IsOnline);

　Response.Write(myuser.PasswordQuestion);

　Response.Write(myuser.UserName);

      }
}

根据密码问题的答案返回用户密码

if (User.Identity.IsAuthenticated)

{
     MembershipUser user = Membership.GetUser(txtUid.Text);
     txtPwd.Text = user.GetPassword(txtAnswer.Text);
}

修改用户密码

if (User.Identity.IsAuthenticated)

{
     MembershipUser user = Membership.GetUser();
     user.ChangePassword(txtPwd.Text,txtPWd2.Text);
     Response.Write(user.GetPassword(txtAnswer.Text));
}

解锁用户

MembershipUser user = Membership.GetUser(txtUid.Text);

bool b = user.UnlockUser();

Response.Write(b+" "+user.IsLockedOut);

拒绝用户登录

MembershipUser user = Membership.GetUser(txtUid.Text);

user.IsApproved = false;

Membership.UpdateUser(user);

Response.Write(user.IsLockedOut);

允许用户登录

MembershipUser user = Membership.GetUser(txtUid.Text);

user.IsApproved = true;

Membership.UpdateUser(user);

Response.Write(user.IsLockedOut);

根据用户名或邮箱来检索用户

　MembershipUserCollection users;

　switch(listType.Text)
　{
　 case   "姓名":
　　users = Membership.FindUsersByName(txtFind.Text);
　　if (users.Count > 0)
　　{
　　     showUserInfo(users);
　　}
　　else
　　{
　　     Response.Write("未找到用户名");
　　}
　　break;
　 case   "邮箱":
　　users = Membership.FindUsersByEmail(txtFind.Text);
　　if (users.Count > 0)
　　{
　　     showUserInfo(users);
　　}
　　else
　　{
　　     Response.Write("未找到邮箱");
　　}
　　break;
　}

代码实现(2)

加载所有用户

MembershipUserCollection user = Membership.GetAllUsers();
listUser.DataSource = user;
listUser.DataBind();

加载所有角色

string[] role = Roles.GetAllRoles();

listRole.DataSource = role;

listRole.DataBind();

添加新角色

Roles.CreateRole(txtRole.Text);

删除角色

Roles.DeleteRole(txtRole.Text);

将一个用户添加到一个角色

Roles.AddUserToRole(listUser.Text, listRole.Text);

将一个用户从一个角色中移除

Roles.RemoveUserFromRole(listUser.Text, listRole.Text);

将一个用户加入到多个角色中去

         int n = 0;
         foreach (ListItem li in listRole.Items)
         {
             if (li.Selected) n++;
         }
         string[] roles = new string[n];
         int i=0;
         foreach(ListItem li in listRole.Items)
         {
             if(li.Selected)
             {
                 roles[i++] = li.Text;
             }
         }
         Roles.AddUserToRoles(listUser.Text, roles);

将一个用户的所有角色移除

string[] str = Roles.GetRolesForUser(listUser.Text);

Roles.RemoveUserFromRoles(listUser.Text,str);

将多个用户加入到一个角色中去

         int n = 0;
         foreach (ListItem li in listUser.Items)
         {
             if (li.Selected) n++;
         }

         string[] users = new string[n];
         int i=0;
         foreach (ListItem li in listUser.Items)
         {
             if (li.Selected)
             {
                 users[i++] = li.Text;
             }
         }
         Roles.AddUsersToRole(users,listRole.Text);

将一个角色中的所有的用户移除

string[] users = Roles.GetUsersInRole(listRole.Text);

Roles.RemoveUsersFromRole(users, listRole.Text);

将多个用户加入到多个角色

         int n = 0;
         foreach (ListItem li in listUser.Items)
         {
             if (li.Selected) n++;
         }
         string[] strUser = new string[n];
         n = 0;
         foreach (ListItem li in listRole.Items)
         {
             if (li.Selected) n++;
         }
         string[] strRoles = new string[n];
         for (int i = 0; i < listUser.Items.Count; i++)
         {
             strUser[i] = listUser.Items[i].Text;
         }
         for (int i = 0; i < listRole.Items.Count; i++)
         {
             strRoles[i] = listRole.Items[i].Text;
         }

         Roles.AddUsersToRoles(strUser, strRoles);

第二部分

玩转Membership之五

-----底层三剑客：Membership、MembershipUser、Roles

本部分内容主要对Membership类、MembershipUser类和Roles类的常用属性和方法进行详尽的介绍。

Membership类属于System.Web.Security命名空间，其中包含了大量有用的静态方法。，下面列出最常用的一些静态方法

 

CreateUser（）

创建一个新用户

举例如下：

MembershipCreateStatus createStatus;

Membership.CreateUser("丰志强", "www.fengzhiqiang.name", "zhiqiangfeng@gmail.com",

"你最喜欢的运动是什么？", "旅游", true, out createStatus);

需 要注意的是倒数第二个参数，它是一个布尔值，决定创建的帐号是否被激活。如果设置为false，则帐号虽然创建成功，但是不可用，还需要在以后将 MembershipUSer的IsApproved属性设置为true，然后调用UpdateUser()方法进行激活。新创建的用户默认情况下是被激 活的。

最后一个参数返回一个枚举值，用以表示创建用户是否成功。MembershipCreateStatus.Success代表创建成功，其他的枚举值代表没有创建成功的各种原因

 

DeleteUser（）

通过提供的用户名字，将数据库中的用户删除。你也可以指定是否从其他表中将与此用户相关的所有信息全部删除，默认情况下是全部删除的。

 

GetUser（）

通过提供的用户名字，从数据库中获取用户

 

GetUserNameByEmail（）

通过邮箱获取用户的名字，如果数据库中存在多个匹配的用户，则只返回第一个用户名

 

FindUsersByName（）

此方法支持模糊查询，返回所有匹配或者部分匹配的用户列表

 

FindUsersByEmail（）

此方法支持模糊查询，返回所有匹配或者部分匹配的用户列表

 

GetAllUsers（）

获取所有用户的集合。此方法的另外一个重载，通过起始序号和集合长度，可以返回所要求的部分用户的集合

 

GetNumberOfUsersOnline（）

获取登陆在线的用户总数

 

GeneratePassword（）

生成指定长度的随机密码

 

UpdateUser（）

更新用户信息

 

ValidateUser（）

对提供的用户名和密码进行验证，检验其是否有效

 

MembershipUser提供如下常用的实例方法

 

UnlockUser（）

激活因多次输入错误密码而被锁定的帐户

 

GetPassword（）

用户通过输入安全问题的答案获取密码。注意的是如果密码是hashed类型，则不可用

 

ResetPassword（）

使用系统生成的新的随机密码对用户密码进行重置。方法的返回值是生成的随机密码。随机密码可以直接显示给用户或者通过邮件的方式发送给用户

 

ChangePassword（）

改变用户密码

 

ChangePasswordQuestionAndAnswer（）

改变安全问题和答案

 

需 要注意的一点是：如果你想让一个帐户不可用，那么只能通过将MembershipUser的IsApproved属性设置为fasle让其处于未激活状 态。而不能通过编程的方式将其锁定，用户帐号的锁定只能由用户连续输错密码去触发，但是我们可以通过调用UnlockUser（）进行解锁操作。

 

使用GridView和DetailsView绑定用户信息关键代码：

     protected void Page_Load(object sender, EventArgs e)

    ...{

        GridView1.DataSource = Membership.GetAllUsers();

        GridView1.DataKeyNames=new string [] ...{"UserName"};

        GridView1.DataBind();

    }

    protected void GridView1_SelectedIndexChanged(object sender, EventArgs e)

    ...{

        List<MembershipUser> list = new List<MembershipUser>();

        list.Add(Membership.GetUser(GridView1.SelectedValue.ToString()));

        DetailsView1.DataSource = list;

        DetailsView1.DataBind();

 

    }

 

在用户点击登陆按钮的时候，我们可以做如下处理

If(Membership.ValidateUser(txtName.text,txtPassword.text))

...{

         FormsAuthentication.RedirectFromLoginPage(txtName,false);

}

Else

...{

         Response.Write(“你的密码无效！”);

}

 

使用Roles类通过编程的方式创建角色和给用户指定角色

 

Roles类常用的方法

CreateRole（）

DeleteRole（）

RoleExists（）

GetAllRoles（）

AddUserToRole（）

AddUserToRoles（）

RemoveUserFromRole（）

RemoveUserFromRoles（）

RemoveUsersFromRole（）

RemoveUsersFromRoles（）

IsUserInRole（）

GetRolesForUser（）

GetUsersInRole（）

FindUsersInRole（）