ASP.NET Web Pages - WebSecurity 对象
描述
WebSecurity 对象提供为 ASP.NET Web Pages 应用程序提供安全和认证。
通过 WebSecurity 对象，您能够创建用户账户、登录和注销，重置或更改密码等等。
WebSecurity 对象参考手册 - 属性
| 属性 | 描述 |
|---|---|
| CurrentUserId | 获取当前用户的 ID。 |
| CurrentUserName | 获取当前用户的名称。 |
| HasUserId | 获取指示当前用户是否具有用户 ID 的值。如果是，返回 true。 |
| IsAuthenticated | 获取当前用户的身份验证状态。 |
WebSecurity 对象参考手册 - 方法
| 属性 | 描述 |
|---|---|
| ChangePassword() | 更改用户的密码。 |
| ConfirmAccount() | 确认帐户有效并激活该帐户。 |
| CreateAccount() | 创建新的用户帐户。 |
| CreateUserAndAccount() | 创建新的用户帐户。 |
| GeneratePasswordResetToken() | 生成可以通过电子邮件发送给用户的密码重置令牌。 |
| GetCreateDate() | 返回创建指定成员资格帐户的日期和时间。 |
| GetPasswordChangeDate() | 返回最近更改指定成员资格帐户密码的日期和时间。 |
| GetPasswordFailures SinceLastSuccess() |
返回自上次成功登录或创建成员资格帐户以来错误输入密码的次数。 |
| GetUserId() | 基于指定用户名返回用户 ID。 |
| GetUserIdFrom PasswordResetToken () |
从密码重置令牌中返回用户 ID。 |
| InitializeDatabaseConnection() | 通过连接到包含用户信息的数据库来初始化成员资格系统。 |
| IsAccountLockedOut() | 指示指定的成员资格帐户是否因为密码尝试失败次数太多而被锁定。 |
| IsConfirmed() | 返回一个值，指示用户是否已经过确认的值。 |
| IsCurrentUser() | 返回一个值，指示已登录用户的用户名是否与指定用户名匹配的值。 |
| Login() | 登录用户。 |
| Logout() | 注销用户。 |
| RequireAuthenticatedUser() | 如果用户未经过身份验证，请将 HTTP 状态设置为 401（未经授权）。 |
| RequireRoles() | 如果当前用户不属于指定的角色，请将 HTTP 状态代码设置为 401。 |
| RequireUser() | 如果当前用户不是指定用户，请将 HTTP 状态设置为 401。 |
| ResetPassword() | 通过使用密码重置令牌来重置密码。 |
| UserExists() | 检查用户是否存在。 |
技术数据
| 名称 | 值 |
|---|---|
| Class | WebMatrix.WebData.WebSecurity |
| Namespace | WebMatrix.WebData |
| Assembly | WebMatrix.WebData.dll |
初始化 WebSecurity 数据库
在代码中使用 WebSecurity 对象之前，必须创建或初始化 WebSecurity 数据库。
在 web 更目录中，创建或编辑 _AppStart.cshtml 页面。
在该文件中写入以下代码：
_AppStart.cshtml
@{
WebSecurity.InitializeDatabaseConnection("Users", "UserProfile", "UserId", "Email",
true);
}
网站每次启动时都会运行以上代码。它会对 WebSecurity 数据库进行初始化。
"Users" 是 WebSecurity 数据库的名称。(Users.sdf)
"UserProfile" 是包含用户配置信息的数据库表的名称。
"UserId" 包含用户 ID 的列的名称（主键）。
"Email" 是包含用户名称的列名。
最后一个参数 true 是一个逻辑值，指示应创建用户配置文件表和成员资格表（如果它们不存在），否则 false。
提示：尽管 true 指示自动创建数据库表，但数据库本身不会被自动创建。它必须存在。
WebSecurity 数据库
UserProfile 表中的每条记录代表一个用户，其中包括用户 ID （主键）和用户名称（email）：
| UserId | |
|---|---|
| 1 | john@johnson.net |
| 2 | peter@peterson.com |
| 3 | lars@larson.eut |
Membership 表包含成员资格信息，比如用户何时创建以及是否（以及何时）确认成员资格。
类似这样（某些列未列出）：
| UserId | 创建日期 | 确认 令牌 |
是否 确认 |
最后的 密码错误 |
密码 | 密码更改 |
|---|---|---|---|---|---|---|
| 1 | 12.04.2012 16:12:17 | NULL | True | NULL | AFNQhWfy.... | 12.04.2012 16:12:17 |
注释：如果您希望看到所有列和所有内容，请通过 WebMatrix 打开数据库，然后查看每张表。
简单的成员资格配置
如果您的站点未配置为使用 ASP.NET Web Pages 成员资格系统 SimpleMembership，那么可能会在使用 WebSecurity 对象时出现错误。
如果主机提供商的配置与您的本地服务器不同，就会发生错误。为了解决这个问题，请在站点的 Web.config 文件中添加以下元素：
<appSettings> <add key="enableSimpleMembership" value="true" /> </appSettings>