Easy Tutorial
Met Websecurity Changepassword Control Listbox Control Htmlinputbutton Prop Webcontrol Linkbutton Postbackurl Prop Webcontrol Listcontrol Selectedindex Prop Webcontrol Listcontrol Items Prop Webcontrol Tablerow Tablesection Met Websecurity Resetpassword Met Websecurity Createaccount Prop Webcontrol Calendar Showdayheader Prop Webcontrol Checkbox Textalign Aspnet Databinding Prop Webcontrol Style Borderstyle Webpages Helpers Webpages Ref Webmail Mvc Reference Prop Webcontrol Listcontrol Text Prop Webcontrol Calendar Todaysdate Met Websecurity Getpasswordchangedate Prop Webcontrol Calendar Nextmonthtext Webpages Ref Websecurity Met Websecurity Logout Control Adrotator Control Hyperlink Webpages Global Webpages Webgrid Prop Webcontrol Standard Borderstyle Prop Webcontrol Calendarday Isweekend Prop Webcontrol Bulletedlist Bulletimageurl Razor Cs Logic Prop Control Standard Visible Prop Webcontrol Tablecell Columnspan Prop Webcontrol Calendar Showgridlines Webpages Ref Database Mvc Security Prop Webcontrol Button Onclientclick Prop Webcontrol Table Caption Prop Webcontrol Tablecell Wrap Prop Webcontrol Adrotator Advertisementfile Aspnet Ref Htmlcontrols Prop Webcontrol Style Backcolor Prop Webcontrol Radiobuttonlist Repeatcolumns Webpages Razor Prop Webcontrol Textbox Text Prop Control Standard Uniqueid Prop Webcontrol Table Horizontalalign Prop Webcontrol Textbox Textmode Control Label Prop Websecurity Hasuserid Prop Webcontrol Standard Style Prop Webcontrol Calendar Selecteddaystyle Prop Webcontrol Textbox Readonly Control Customvalidator Control Reqfieldvalidator Aspnet Intro Prop Control Standard Page Prop Webcontrol Calendarday Isselected Prop Webcontrol Radiobuttonlist Repeatlayout 2 Prop Webcontrol Hyperlink Target Prop Webcontrol Image Imageurl Prop Webcontrol Bulletedlist Target Met Websecurity Isconfirmed Prop Webcontrol Calendar Selectorstyle Control Checkboxlist Webpages Php Webpages Folders Prop Webcontrol Button Text Mvc Models Prop Webcontrol Calendar Weekenddaystyle Index Prop Webcontrol Standard Tabindex Prop Webcontrol Listcontrol Datavaluefield Prop Webcontrol Listitem Selected Control Style Prop Webcontrol Standard Tooltip Mvc Layout Control Htmlinputimage Prop Webcontrol Style Bordercolor Prop Webcontrol Standard Borderwidth Control Comparevalidator Aspnet Xml Webpages Layout Razor Intro Control Calendarday Razor Vb Logic Prop Webcontrol Button Validationgroup Prop Webcontrol Imagebutton Validationgroup Prop Webcontrol Table Gridlines Prop Webcontrol Button Postbackurl Prop Webcontrol Adrotator Target Prop Webcontrol Tablecell Verticallalign Webpages Intro Met Websecurity Iscurrentuser Control Htmlinputtext Prop Webcontrol Standard Height Control Htmlinputcheckbox Prop Webcontrol Textbox Autopostback Control Htmlform Prop Webcontrol Calendar Selecteddates Prop Websecurity Isauthenticated Control Linkbutton Control Panel Control Placeholder Mvc Folders Prop Webcontrol Panel Wrap Control Radiobuttonlist Aspnet Ref Webcontrols Prop Webcontrol Style Borderwidth Aspnet Arraylist Prop Webcontrol Standard Bordercolor Prop Webcontrol Radiobuttonlist Repeatdirection Met Websecurity Confirmaccount Prop Webcontrol Standard Backcolor Webpages Ref Classes Control Image Control Bulletedlist Prop Webcontrol Calendarday Istoday Aspnet Events Prop Webcontrol Table Cellpadding Aspnet Repeater Met Websecurity Createuserandaccount Control Imagebutton Prop Webcontrol Panel Groupingtext Prop Webcontrol Tablecell Rowspan Prop Webcontrol Calendar Prevmonthtext Prop Webcontrol Calendar Nextprevformat Prop Webcontrol Calendar Selectweektext Prop Webcontrol Checkboxlist Repeatlayout Prop Webcontrol Image Alternatetext Prop Webcontrol Calendarday Date Prop Webcontrol Listitem Value Prop Webcontrol Calendar Shownextprevmonth Prop Webcontrol Linkbutton Onclientclick Prop Webcontrol Panel Defaultbutton Aspnet Tutorial Prop Webcontrol Table Cellspacing Control Htmlimage Prop Webcontrol Calendar Selectmonthtext Prop Webcontrol Panel Backimageurl Control Xml Razor Syntax Prop Webcontrol Standard Cssclass Met Websecurity Generatepasswordresettoken Control Htmltablecell Prop Webcontrol Bulletedlist Displaymode Control Checkbox Control Htmlinputfile Prop Webcontrol Imagebutton Postbackurl Prop Webcontrol Calendar Daystyle Control Rangevalidator Met Websecurity Requireroles Prop Webcontrol Bulletedlist Bulletstyle Prop Webcontrol Calendar Todaydaystyle Prop Webcontrol Listitem Text Control Radiobutton Prop Webcontrol Tablecell Text Prop Websecurity Currentuserid Control Dropdownlist Mvc Intro Prop Webcontrol Calendar Othermonthdaystyle Prop Webcontrol Textbox Rows Prop Webcontrol Calendarday Isothermonth Aspnet Masterpages Control Htmlinputradiobutton Prop Webcontrol Imagebutton Onclientclick Prop Webcontrol Radiobuttonlist Repeatlayout Prop Webcontrol Textbox Autocompletetype Control Htmltextarea Aspnet Viewstate Prop Webcontrol Style Height Met Websecurity Userexists Prop Webcontrol Checkbox Text Prop Webcontrol Calendar Caption Control Tablerow Prop Webcontrol Button Causesvalidation Prop Webcontrol Textbox Columns Prop Webcontrol Imagebutton Causesvalidation Prop Control Standard Clientid Control Htmltable Control Validationsummary Prop Webcontrol Linkbutton Validationgroup Control Htmlinputhidden Prop Webcontrol Textbox Maxlength Aspnet Dbconnection Met Websecurity Getcreatedate Razor Cs Variables Met Websecurity Login Prop Webcontrol Panel Direction Aspnet Sortedlist Prop Webcontrol Calendar Cellpadding Aspnet Button Prop Webcontrol Literal Text Prop Webcontrol Hyperlink Text Prop Websecurity Currentusername Prop Webcontrol Calendar Captionalign Prop Webcontrol Hyperlink Navigateurl Razor Vb Variables Control Listitem Prop Webcontrol Calendarday Daynumbertext Prop Webcontrol Checkboxlist Textalign Prop Control Standard Bindingcontainer Prop Control Standard Parent Prop Webcontrol Image Imagealign Met Websecurity Getuserid Prop Webcontrol Calendar Firstdayofweek Control Table Control Listcontrol Prop Webcontrol Calendar Nextprevstyle Prop Webcontrol Listcontrol Validationgroup Prop Webcontrol Calendar Cellspacing Prop Webcontrol Checkboxlist Repeatcolumns Webpages Objects Razor Vb Loops Aspnet Examples Prop Webcontrol Listbox Rows Prop Webcontrol Standard Accesskey Prop Control Standard Id Prop Webcontrol Linkbutton Text Prop Webcontrol Textbox Wrap Mvc App Control Calendar Prop Webcontrol Listitem Enabled Webpages Publish Aspnet Forms Webpages Ref Helpers Control Button Prop Webcontrol Style Forecolor Met Websecurity Requireauthenticateduser Aspnet Ref Validationcontrols Prop Webcontrol Standard Forecolor Prop Webcontrol Standard Prop Control Standard Prop Webcontrol Table Captionalign Prop Webcontrol Hyperlink Imageurl Prop Webcontrol Checkboxlist Cellpadding Aspnet Prop Control Standard Namingcontainer Met Websecurity Requireuser Prop Webcontrol Listcontrol Selecteditem Webpages Files Prop Webcontrol Tablerow Verticalalign Met Websecurity Initializedatabaseconnection Prop Webcontrol Listbox Selectionmode Prop Webcontrol Bulletedlist Firstbulletnumber Mvc Database Prop Webcontrol Calendar Selectionmode Mvc Views Prop Webcontrol Style Width Prop Webcontrol Tablerow Horizontalalign Mvc Controllers Webpages Examples Prop Webcontrol Checkboxlist Repeatdirection Aspnet Navigation Prop Webcontrol Checkboxlist Cellspacing Prop Webcontrol Standard Font Prop Webcontrol Calendar Dayheaderstyle Control Regularexpvalidator Mvc Publish Prop Webcontrol Xml Documentsource Aspnet Controls Prop Webcontrol Dropdownlist Selectedindex Prop Webcontrol Tablecell Horizontalalign Control Htmlanchor Aspnet Hashtable Webpages Forms Prop Webcontrol Standard Enabled Control Literal Prop Webcontrol Panel Scrollbars Mvc Htmlhelpers Prop Webcontrol Table Backimageurl Aspnet Pages Prop Webcontrol Radiobuttonlist Textalign Prop Webcontrol Calendarday Isselectable Prop Webcontrol Style Cssclass Prop Webcontrol Listcontrol Autopostback Prop Webcontrol Style Font Razor Cs Loops Prop Webcontrol Radiobuttonlist Cellspacing Prop Webcontrol Checkbox Checked Webpages Chart Control Textbox Aspnet Datalist Prop Webcontrol Listcontrol Datatextfield Control Htmlselect Prop Webcontrol Calendar Titlestyle Prop Webcontrol Button Usesubmitbehavior Prop Webcontrol Calendar Titleformat Prop Webcontrol Calendar Selecteddate Prop Webcontrol Listcontrol Selectedvalue Control Tablecell Aspnet Textbox Webpages Email Prop Webcontrol Panel Horizontalalign Control Htmlgeneric Control Htmlbutton Prop Webcontrol Calendar Showtitle Prop Webcontrol Calendar Daynameformat Prop Webcontrol Calendar Visibledate Control Htmltablerow Prop Webcontrol Radiobuttonlist Cellpadding
❮ Prop Webcontrol Calendar Nextmonthtext Met Websecurity Logout ❯

ASP.NET Web Pages - WebSecurity Object

Description

The WebSecurity Object provides security and authentication for ASP.NET Web Pages applications.

Through the WebSecurity object, you can create user accounts, log in and out users, reset or change passwords, and perform many other security-related functions.

WebSecurity Object Reference Manual - Properties

Property Description
CurrentUserId Gets the ID of the currently logged-in user.
CurrentUserName Gets the name of the currently logged-in user.
HasUserId Returns true if there is a current user ID.
IsAuthenticated Returns true if the current user is logged in.

WebSecurity Object Reference Manual - Methods

Method Description
ChangePassword() Changes the password for the specified user.
ConfirmAccount() Confirms an account with an account confirmation token.
CreateAccount() Creates a new user account.
CreateUserAndAccount() Creates a new user account.
GeneratePasswordResetToken() Generates a password reset token that can be emailed to the user for password reset.
GetCreateDate() Gets the date the specified member was created.
GetPasswordChangeDate() Gets the date and time when the password was changed.
GetUserId() Gets the user ID from the user name.
InitializeDatabaseConnection() Initializes the WebSecurity system (database).
IsConfirmed() Checks if the user has been confirmed. Returns true if confirmed. (For example, confirmed via email.)
IsCurrentUser() Checks if the current user's name matches the specified user name. Returns true if it matches.
Login() Sets the authentication token to log in the user.
Logout() Removes the authentication token to log out the user.
RequireAuthenticatedUser() Sets the HTTP status to 401 (Unauthorized) if the user is not authenticated.
RequireRoles() Sets the HTTP status to 401 (Unauthorized) if the current user is not a member of the specified roles.
RequireUser() Sets the HTTP status to 401 (Unauthorized) if the current user is not the specified user name.
ResetPassword() Changes the user's password to a new password if the password reset token is valid.
UserExists() Checks if the specified user exists.

Technical Data

Name Value
Class WebMatrix.WebData.WebSecurity
Namespace WebMatrix.WebData
Assembly WebMatrix.WebData.dll

Initialize WebSecurity Database

If you want to use the WebSecurity object in your code, you must first create or initialize the WebSecurity database.

In your web root directory, create a page named _AppStart.cshtml (if it already exists, edit the page).

Copy the following code into the file:

_AppStart.cshtml

The code above will run every time the website (application) starts. It initializes the WebSecurity database.

"Users" is the name of the WebSecurity database (Users.sdf).

"UserProfile" is the name of the database table that contains user profile information.

"UserId" is the name of the column that contains the user ID (primary key).

"Email" is the name of the column that contains the user name.

The last parameter true is a Boolean value indicating that if the user profile table and membership table do not exist, they will be created automatically. If you do not want to create tables automatically, set the parameter to false.

| | Although true indicates automatic creation of database tables, the database itself will not be created automatically. Therefore, the database must exist. | | --- | --- |

WebSecurity Database

The UserProfile table creates a record for each user, with the user ID (primary key) and user name (email):

UserId Email
1 [email protected]
2 [email protected]
3 [email protected]

The Membership table contains membership information, such as when the user was created, whether the membership has been confirmed, when the membership was confirmed, etc.

As follows (some columns are not displayed):

UserId CreateDate ConfirmationToken IsConfirmed LastPasswordFailure Password PasswordChange
1 12.04.2012 16:12:17 NULL True NULL AFNQhWfy.... 12.04.2012 16:12:17

Note: If you want to see all columns and contents, open the database and look at each table.

Simple Membership Configuration

When using the WebSecurity object, you may encounter errors if your site is not configured to use the ASP.NET Web Pages membership system SimpleMembership.

Errors may also occur if the configuration of the hosting service provider's server differs from that of your local server. To resolve this issue, add the following element to the Web.config file of your website:

❮ Prop Webcontrol Calendar Nextmonthtext Met Websecurity Logout ❯