Home   |   QuickStart Welcome   |   ASP.NET   |   Web Services   |   How Do I...?   
  |   I want my samples in...      

ASP.NET 2.0 Quickstart Tutorials

Using the Login Controls

The following examples demonstrate how to use the login controls in an application.

Creating and Logging In a User

In this example we see a home page of a website which includes a control that prompts the user to login to the website. The LoginStatus control on this page determines that the user is not currently authenticated and displays a Login link to the user. Clicking on this link takes the user to the default login.aspx page which is configured in the forms authentication section of web.config. The control is displayed on the Login.aspx page. (Note: The login control�s VisibleWhenLoggedIn property is ignored on the default login page s.) In this example, the login control sets additional properties to display the Create User link, clicking this link takes the user to another page where the control is used. By default the CreateUserWizard control is a two step process, on the first step a user enters the required information and when they click the create user button the control passes the information to the membership API. If the user can not be created by the membership API an appropriate error message is shown within the control or if the user is created they the control loads the second step in the wizard. In this example the ContinueDestinationPageUrl property has been set to return the user to the home page once they have been created. By default the CreateUserWizard control authenticates or �logs-in� users when they are successfully created. When a user is returned to the homepage they will notice that the LoginStatus control has detected that they are now authenticated and displays a logout link. Clicking on the logout link causes the user's authentication ticket to be cleared and toggles the display to the login link. At this point the user can click the login link, and since they have already created a user account, they can enter their username and password on the login.aspx to login to the website. You will notice that the Login control displays a remember me checkbox. Checking this box and successfully logging in will cause a persistent (50 year expiration by default) cookie to be written to the user�s machine. You can disable this option in the Login control by setting the DisplayRememberMe and the RememberMeSet properties are set to false. By reviewing the source for this example you will see that no code was written and that very few properties were set to enable this entire scenario. Style properties for these controls were set via a stylesheet applied to the site.

VB LoginStatus, Login and CreateUserWizard
Run Sample View Source

Displaying Different Content for Authenticated Users

This sample illustrates how to use a control to display different content for authenticated and anonymous users. Although, not shown in this example the LoginView control also supports displaying different content based on a user's role. The in the LoginView control contains a login control and the contains the LoginName control. The LoginName controls takes advantage of the formatstring property to display Welcome, followed by the user's name. To see both templates login to the site using a previously created user account or create a new account, to return to the anonymous content click the Logout link at the top of the page.

VB LoginView and LoginName
Run Sample View Source

Changing a Password

The ChangePassword control by default requires the user to be authenticated on the site prior to changing their password. However, in this example we have set the DisplayUserName property to true, as a result a user can be authenticated by the ChangePassword control prior to changing their password or a user who is already authenticated on the site can enter a different user account and authenticate as that user prior to changing their password. The sample also links to a CreateUser page that will let you create a valid user to test this scenario.

VB ChangePassword
Run Sample View Source