ASP.NET参考手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
directory search
ASP.NET 基础教程 ASP.NET 教程 Web Pages - 教程 Web Pages - 添加 Razor 代码 Web Pages - 页面布局 Web Pages - 文件夹 Web Pages - 全局页面 Web Pages - HTML 表单 Web Pages - 对象 Web Pages - 文件 Web Pages - 帮助器 Web Pages - WebGrid 帮助器 Web Pages - Chart 帮助器 Web Pages - WebMail 帮助器 Web Pages - PHP Web Pages - 发布网站 Razor - 标记 Web Pages - Database 对象 ASP.NET MVC Web Forms - 教程 Web Forms - HTML 页面 Web Forms - 服务器控件 Web Forms - 事件 Web Forms - HTML 表单 Web Forms - 维持 ViewState Web Forms - TextBox 控件 Web Forms - Button 控件 Web Forms - 数据绑定 Web Forms - ArrayList 对象 Web Forms - Hashtable 对象 Web Forms - SortedList 对象 Web Forms - XML 文件 Web Forms - Repeater 控件 Web Forms - DataList 控件 Web Forms - 数据库连接 Web Forms - 母版页 Web Forms - 导航 ASP.NET Razor Razor - C# 和 VB 代码语法 Razor - C# 变量 Razor - C# 循环和数组 Razor - C# 逻辑条件 Razor - VB 变量 Razor - VB 循环和数组 Razor - VB 逻辑条件 WF 参考手册 Web Forms - HTML 服务器控件 ASP.NET HtmlAnchor 控件 ASP.NET HtmlButton 控件 ASP.NET HtmlForm 控件 ASP.NET HtmlGeneric 控件 ASP.NET HtmlImage 控件 ASP.NET HtmlInputButton 控件 ASP.NET HtmlInputCheckBox 控件 ASP.NET HtmlInputFile 控件 ASP.NET HtmlInputHidden 控件 ASP.NET HtmlInputImage 控件 ASP.NET HtmlInputRadioButton 控件 ASP.NET HtmlInputText 控件 ASP.NET HtmlSelect Control ASP.NET HtmlTable 控件 ASP.NET HtmlTableCell 控件 ASP.NET HtmlTableRow 控件 ASP.NET HtmlTextArea 控件 ASP.NET AdRotator 控件 ASP.NET AdRotator AdvertisementFile 属性 ASP.NET AdRotator Target 属性 ASP.NET Button 控件 ASP.NET Button CausesValidation 属性 ASP.NET Button OnClientClick 属性 ASP.NET Button PostBackUrl 属性 ASP.NET Button Text 属性 ASP.NET Button UseSubmitBehavior 属性 ASP.NET Button ValidationGroup 属性 ASP.NET Calendar 控件 ASP.NET Calendar Caption 属性 ASP.NET Calendar CaptionAlign 属性 ASP.NET Calendar CellPadding 属性 ASP.NET Calendar CellSpacing 属性 ASP.NET Calendar DayHeaderStyle 属性 ASP.NET Style 控件 ASP.NET BackColor 属性 ASP.NET BorderColor 属性 ASP.NET BorderStyle 属性 ASP.NET BorderWidth 属性 ASP.NET CssClass 属性 ASP.NET Font 属性 ASP.NET ForeColor 属性 ASP.NET Height 属性 ASP.NET Width 属性 ASP.NET Calendar DayNameFormat 属性 ASP.NET Calendar DayStyle 属性 ASP.NET Calendar FirstDayOfWeek 属性 ASP.NET Calendar NextMonthText 属性 ASP.NET Calendar NextPrevFormat 属性 ASP.NET Calendar NextPrevStyle 属性 ASP.NET Calendar OtherMonthDayStyle 属性 ASP.NET Calendar PrevMonthText 属性 ASP.NET Calendar SelectedDate 属性 ASP.NET Calendar SelectedDates 属性 ASP.NET Calendar SelectedDayStyle 属性 ASP.NET Calendar SelectionMode 属性 ASP.NET Calendar SelectMonthText 属性 ASP.NET Calendar SelectorStyle 属性 ASP.NET Calendar SelectWeekText 属性 ASP.NET Calendar ShowDayHeader 属性 ASP.NET Calendar ShowGridLines 属性 ASP.NET Calendar ShowNextPrevMonth 属性 ASP.NET Calendar ShowTitle 属性 ASP.NET Calendar TitleFormat 属性 ASP.NET Calendar TitleStyle 属性 ASP.NET Calendar TodayDayStyle 属性 ASP.NET Calendar TodaysDate 属性 ASP.NET Calendar VisibleDate 属性 ASP.NET Calendar WeekendDayStyle 属性 ASP.NET CalendarDay 控件 ASP.NET CalendarDay Date 属性 ASP.NET CalendarDay DayNumberText 属性 ASP.NET CalendarDay IsOtherMonth 属性 ASP.NET CalendarDay IsSelectable 属性 ASP.NET CalendarDay IsSelected 属性 ASP.NET CalendarDay IsToday 属性 ASP.NET CalendarDay IsWeekend 属性 ASP.NET CheckBox 控件 ASP.NET CheckBox Checked 属性 ASP.NET CheckBox Text 属性 ASP.NET CheckBox TextAlign 属性 ASP.NET CheckBoxList 控件 ASP.NET CheckBoxList CellPadding 属性 ASP.NET CheckBoxList CellSpacing 属性 ASP.NET CheckBoxList RepeatColumns 属性 ASP.NET CheckBoxList RepeatDirection 属性 ASP.NET CheckBoxList RepeatLayout 属性 ASP.NET CheckBoxList TextAlign 属性 ASP.NET DropDownList 控件 ASP.NET DropDownList SelectedIndex 属性 ASP.NET HyperLink 控件 ASP.NET HyperLink ImageUrl 属性 ASP.NET HyperLink NavigateUrl 属性 ASP.NET HyperLink Target 属性 ASP.NET HyperLink Text 属性 ASP.NET Image 控件 ASP.NET Image AlternateText 属性 ASP.NET Image ImageAlign 属性 ASP.NET Image ImageUrl 属性 ASP.NET ImageButton 控件 ASP.NET ImageButton CausesValidation 属性 ASP.NET ImageButton ValidationGroup 属性 ASP.NET ImageButton PostBackUrl 属性 ASP.NET ImageButton ValidationGroup 属性 ASP.NET Label 控件 ASP.NET LinkButton 控件 ASP.NET LinkButton OnClientClick 属性 ASP.NET LinkButton PostBackUrl 属性 ASP.NET LinkButton Text 属性 ASP.NET LinkButton ValidationGroup 属性 ASP.NET ListBox 控件 ASP.NET Rows 属性 ASP.NET SelectionMode 属性 ASP.NET ListItem 控件 ASP.NET ListItem Enabled 属性 ASP.NET ListItem Selected 属性 ASP.NET ListItem Text 属性 ASP.NET ListItem Value 属性 ASP.NET Literal 控件 ASP.NET Literal Text 属性 ASP.NET Panel 控件 ASP.NET Panel BackImageUrl 属性 ASP.NET Panel DefaultButton 属性 ASP.NET Panel Direction 属性 ASP.NET Panel GroupingText 属性 ASP.NET Panel HorizontalAlign 属性 ASP.NET Panel ScrollBars 属性 ASP.NET Panel Wrap 属性 ASP.NET PlaceHolder 控件 ASP.NET RadioButton 控件 ASP.NET RadioButtonList 控件 ASP.NET RadioButtonList CellPadding 属性 ASP.NET RadioButtonList CellSpacing 属性 ASP.NET RadioButtonList RepeatColumns 属性 ASP.NET RadioButtonList RepeatDirection 属性 ASP.NET RadioButtonList TextAlign 属性 ASP.NET BulletedList BulletImageUrl 属性 Web Forms - Web 服务器控件 ASP.NET Table 控件 ASP.NET BackImageUrl 属性 ASP.NET Caption 属性 ASP.NET CaptionAlign 属性 ASP.NET CellPadding 属性 ASP.NET CellSpacing 属性 ASP.NET GridLines 属性 ASP.NET HorizontalAlign 属性 ASP.NET TableCell 控件 ASP.NET TableCell ColumnSpan 属性 ASP.NET TableCell HorizontalAlign 属性 ASP.NET TableCell RowSpan 属性 ASP.NET TableCell Text 属性 ASP.NET TableCell Wrap 属性 ASP.NET TableRow 控件 ASP.NET TableRow HorizontalAlign 属性 ASP.NET TableRow TableSection 属性 ASP.NET TableRow VerticalAlign 属性 ASP.NET TextBox 控件 ASP.NET TextBox AutoCompleteType 属性 ASP.NET TextBox AutoPostBack 属性 ASP.NET TextBox Columns 属性 ASP.NET TextBox MaxLength 属性 ASP.NET TextBox ReadOnly 属性 ASP.NET TextBox Rows 属性 ASP.NET TextBox Text 属性 ASP.NET TextBox TextMode 属性 ASP.NET TextBox Wrap 属性 ASP.NET XML 控件 ASP.NET XML DocumentSource 属性 Web Forms - Validation 服务器控件 ASP.NET CompareValidator 控件 ASP.NET CustomValidator 控件 ASP.NET RangeValidator 控件 ASP.NET RegularExpressionValidator 控件 ASP.NET RequiredFieldValidator 控件 ASP.NET ValidationSummary 控件 ASP.NET BulletedList 控件 ASP.NET BulletedList BulletStyle 属性 ASP.NET BulletedList DisplayMode 属性 ASP.NET BulletedList FirstBulletNumber 属性 ASP.NET BulletedList Target 属性 WP 参考手册 Web Pages - 类 Web Pages - WebSecurity 对象 WebSecurity 属性 - CurrentUserId WebSecurity 属性 -?CurrentUserName WebSecurity 属性 - HasUserId WebSecurity 属性 - IsAuthenticated WebSecurity - ChangePassword() WebSecurity - ConfirmAccount() WebSecurity - CreateAccount() WebSecurity - CreateUserAndAccount() WebSecurity - GeneratePasswordResetToken() WebSecurity - GetCreateDate() WebSecurity - GetPasswordChangeDate() WebSecurity - GetUserId() WebSecurity - InitializeDatabaseConnection() WebSecurity - IsConfirmed() WebSecurity - IsCurrentUser() WebSecurity - Login() WebSecurity - Logout() WebSecurity - RequireAuthenticatedUser() WebSecurity - RequireRoles() WebSecurity - RequireUser() WebSecurity - ResetPassword() WebSecurity - UserExists() Web Pages - WebMail 对象 Web Pages - 更多帮助器

©
This document uses PHP Chinese website manual Release

characters

Web Pages - WebSecurity 对象

描述

WebSecurity 对象提供 ASP.NET Web Pages 应用程序的安全性和认证。

通过 WebSecurity 对象，您可以创建用户帐户，登录和注销用户，重置或者更改密码，以及其他更多与安全性相关的功能。

WebSecurity 对象参考手册 - 属性

属性 描述
CurrentUserId 获取当前登录用户的 ID。
CurrentUserName 获取当前登录用户的名称。
HasUserId 如果当前有用户 ID，则返回 true。
IsAuthenticated 如果当前用户是登录的，则返回 true。

WebSecurity 对象参考手册 - 方法

方法 描述
ChangePassword() 为指定的用户更改密码。
ConfirmAccount() 使用帐户确认令牌确认帐户。
CreateAccount() 创建一个新的用户帐户。
CreateUserAndAccount() 创建一个新的用户帐户。
GeneratePasswordResetToken() 生成一个密码重置令牌，可以在电子邮件中发送给用户以便用户可以重设密码。
GetCreateDate() 获取指定会员创建的时间。
GetPasswordChangeDate() 获取密码变更的日期和时间。
GetUserId() 根据用户名称获取用户 ID。
InitializeDatabaseConnection() 初始化 WebSecurity 系统（数据库）。
IsConfirmed() 检查用户是否已被确认。如果已确认，则返回 true。（例如，可通过电子邮件进行确认。）
IsCurrentUser() 检查当前用户的名称是否与指定用户名匹配。如果匹配，则返回 true。
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 Email
1 john@johnson.net
2 peter@peterson.com
3 lars@larson.eut

Membership 表包含会员信息，比如用户是什么时候创建的，该会员是否已认证，会员是什么时候认证的，等等。

具体如下所示（一些列不显示）：

User
Id		 Create
Date		 Confirmation
Token		 Is
Confirmed		 Last
Password
Failure		 Password Password
Change
1 12.04.2012 16:12:17 NULL True NULL AFNQhWfy.... 12.04.2012 16:12:17

注释：如果您想看到所有的列和内容，请打开数据库，看看里边的每个表。

简单的会员配置

在您使用 WebSecurity 对象时，如果您的站点没有配置使用 ASP.NET Web Pages 会员系统 SimpleMembership，可能会报错。

如果托管服务提供商的服务器的配置与您本地服务器的配置不同，也可能会报错。为了解决这个问题，请在网站的 Web.config 文件中添加以下元素：

 <appSettings> 
<add key="enableSimpleMembership" value="true" /> 
 </appSettings>


Previous article： Next article：