Export (0) Print
Expand All
0 out of 2 rated this helpful - Rate this topic

CreateUserWizardStep Class

Contains basic functionality for creating a user in a step that can be templated. This class cannot be inherited.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public sealed class CreateUserWizardStep : TemplatedWizardStep
public final class CreateUserWizardStep extends TemplatedWizardStep
public final class CreateUserWizardStep extends TemplatedWizardStep
Not applicable.

The CreateUserWizard control creates new user accounts in a Web site's user data store. The CreateUserWizardStep is, by default, the first step within the CreateUserWizard control. The CreateUserWizardStep step is a required step within the CreateUserWizard control.

The CreateUserWizardStep class is derived from the TemplatedWizardStep class. The CreateUserWizardStep is displayed in the CreateUserWizard control before the CompleteWizardStep step.

NoteNote:

Although the CreateUserWizardStep step is the first step in the wizard by default, it is possible to provide a different first step. Doing so, however, can affect whether the Previous button is displayed. For example, if the CreateUserWizardStep step does not have a custom navigation template, and is preceded by another step that is rendered before CreateUserWizardStep, then the Previous button is displayed on the CreateUserWizardStep step at run time. If the CreateUserWizardStep step is rendered before the alternate "first" step, then the Previous button is not displayed. Furthermore, the Previous button is never rendered at design time. If you want the Previous button to be rendered at design time, you must add it to the custom navigation template of the CreateUserWizardStep step.

You can modify the CreateUserWizardStep step to contain additional fields, or change the display order of the fields included in the CreateUserWizardStep step, by editing the template associated with the control.

The new Web site user account is created in the data store when the user clicks the Next button on the CreateUserWizardStep step. By default, the AllowReturn property is set to false to keep the user from returning to the CreateUserWizardStep step and accidentally attempting to create another user account with the same credentials. If you set the AllowReturn property to true, you must include logic in your application to remove the user account that was originally created before the user returned to this step, or to allow the user to edit information he or she originally entered.

TopicLocation
How to: Customize the ASP.NET CreateUserWizard ControlBuilding ASP .NET Web Applications
How to: Customize the ASP.NET CreateUserWizard ControlBuilding ASP .NET Web Applications

The first code example uses the short-form declarative syntax of the CreateUserWizardStep class to add an additional control to a CreateUserWizard control. The code example requires the following entries in the Web.config file.

<configuration>

<system.web>

<profile>

<properties>

<add name="lastName" />

<add name="firstName" />

</properties>

</profile>

</system.web>

</configuration>

Security noteSecurity Note:

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview (Visual Studio).

<%@ page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CreateUserWizard1_CreatedUser(object sender, EventArgs e)
{
  Profile.SetPropertyValue("userName",firstName.Text + " " + lastName.Text);  
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      CreateUserWizard.CreatedUser sample</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <div>
        <asp:createuserwizard id="CreateUserWizard1" 
                              oncreateduser="CreateUserWizard1_CreatedUser"
                              runat="server">
          <wizardsteps>
            <asp:wizardstep runat="server" steptype="Start" title="Identification">
              Tell us your name:<br />
              <table width="100%">
                <tr>
                  <td>
                    First name:</td>
                  <td>
                    <asp:textbox id="firstName" runat="server" /></td>
                </tr>
                <tr>
                  <td>
                    Last name:</td>
                  <td>
                    <asp:textbox id="lastName" runat="server" /></td>
                </tr>
              </table>
            </asp:wizardstep>
            <asp:createuserwizardstep runat="server" title="Sign Up for Your New Account">
            </asp:createuserwizardstep>
          </wizardsteps>
        </asp:createuserwizard>
      </div>
    </form>
  </body>
</html>

Security noteSecurity Note:

This control has a text box that accepts user input, which is a potential security threat. User input in a Web page can potentially contain malicious client script. By default, ASP.NET Web pages validate user input to ensure that the input does not contain HTML elements or script. As long as this validation is enabled, you do not need to explicitly check for script or HTML elements in user input. For more information, see Script Exploits Overview (Visual Studio).

The second code example lists the complete CreateUserWizardStep control.

<%@ page language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>CreateUserWizard Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:createuserwizard id="CreateUserWizard1" 
        runat="server">
        <wizardsteps>
          <asp:createuserwizardstep id="CreateUserWizardStep1" 
            runat="server" 
            title="Sign Up for Your New Account">
            <contenttemplate>
              <table border="0">
                <tr>
                  <td>
                    <table border="0" style="height: 100%; width: 100%;">
                      <tr>
                        <td align="center" colspan="2">
                          Sign Up for Your New Account</td>
                      </tr>
                      <tr>
                        <td align="right">
                          <asp:label runat="server" 
                            associatedcontrolid="UserName" 
                            id="UserNameLabel">
                            User Name:
                          </asp:label>
                        </td>
                        <td>
                          <asp:textbox runat="server" id="UserName"></asp:textbox>
                          <asp:requiredfieldvalidator runat="server" 
                            controltovalidate="UserName" 
                            tooltip="User Name is a required field."
                            id="UserNameRequired" 
                            validationgroup="CreateUserWizard1" 
                            errormessage="User Name is a required field.">
                            *
                          </asp:requiredfieldvalidator>
                        </td>
                      </tr>
                      <tr>
                        <td align="right">
                          <asp:label runat="server" 
                            associatedcontrolid="Password" 
                            id="PasswordLabel">
                            Password:</asp:label>
                        </td>
                        <td>
                          <asp:textbox runat="server" textmode="Password" id="Password"></asp:textbox>
                          <asp:requiredfieldvalidator runat="server" 
                            controltovalidate="Password" 
                            tooltip="Password is a required field."
                            id="PasswordRequired" 
                            validationgroup="Createuserwizard1" 
                            errormessage="Password is a required field.">
                            *
                          </asp:requiredfieldvalidator>
                        </td>
                      </tr>
                      <tr>
                        <td align="right">
                          <asp:label runat="server" 
                            associatedcontrolid="ConfirmPassword" 
                            id="ConfirmPasswordLabel">
                            Confirm Password:
                          </asp:label>
                        </td>
                        <td>
                          <asp:textbox runat="server" textmode="Password" id="ConfirmPassword"></asp:textbox>
                          <asp:requiredfieldvalidator runat="server" 
                            controltovalidate="ConfirmPassword" 
                            tooltip="Confirm Password is a required field."
                            id="ConfirmPasswordRequired" 
                            validationgroup="CreateUserWizard1" 
                            errormessage="Confirm Password is a required field.">
                            *
                          </asp:requiredfieldvalidator>
                        </td>
                      </tr>
                      <tr>
                        <td align="right">
                          <asp:label runat="server" 
                            associatedcontrolid="Email" 
                            id="EmailLabel">
                            Email:
                          </asp:label>
                        </td>
                        <td>
                          <asp:textbox runat="server" id="Email"></asp:textbox>
                          <asp:requiredfieldvalidator runat="server" 
                            controltovalidate="Email" 
                            tooltip="E-mail is a required field."
                            id="EmailRequired" 
                            validationgroup="Createuserwizard1" 
                            errormessage="E-mail is a required field.">
                            *
                          </asp:requiredfieldvalidator>
                        </td>
                      </tr>
                      <tr>
                        <td align="right">
                          <asp:label runat="server" 
                            associatedcontrolid="Question" 
                            id="QuestionLabel">
                            Security Question:
                          </asp:label>
                        </td>
                        <td>
                          <asp:textbox runat="server" id="Question"></asp:textbox>
                          <asp:requiredfieldvalidator runat="server" 
                            controltovalidate="Question" 
                            tooltip="Security Question is a required field."
                            id="QuestionRequired" 
                            validationgroup="CreateUserWizard1" 
                            errormessage="Security Question is a required field.">
                            *
                          </asp:requiredfieldvalidator>
                        </td>
                      </tr>
                      <tr>
                        <td align="right">
                          <asp:label runat="server" 
                            associatedcontrolid="Answer" 
                            id="AnswerLabel">
                            Security Answer:
                          </asp:label>
                        </td>
                        <td>
                          <asp:textbox runat="server" id="Answer"></asp:textbox>
                          <asp:requiredfieldvalidator runat="server" 
                            controltovalidate="Answer" 
                            tooltip="Security Answer is a required field."
                            id="AnswerRequired" 
                            validationgroup="CreateUserWizard1" 
                            errormessage="Security Answer is a required field.">
                            *
                          </asp:requiredfieldvalidator>
                        </td>
                      </tr>
                      <tr>
                        <td align="center" colspan="2">
                          <asp:comparevalidator runat="server" 
                            display="Dynamic" 
                            errormessage="The Password and Confirm Password fields must match."
                            controltocompare="ConfirmPassword" 
                            controltovalidate="Password" 
                            id="PasswordCompare"
                            validationgroup="CreateUserWizard1">
                          </asp:comparevalidator>
                        </td>
                      </tr>
                      <tr>
                        <td align="center" colspan="2" style="color: Red;">
                          <asp:literal runat="server" 
                            enableviewstate="False" 
                            id="FailureText">
                          </asp:literal>
                        </td>
                      </tr>
                    </table>
                  </td>
                </tr>
              </table>
            </contenttemplate>
          </asp:createuserwizardstep>
          <asp:completewizardstep ID="CompleteWizardStep1" 
            runat="server" 
            title="Complete">
            <contenttemplate>
              <table border="0">
                <tr>
                  <td>
                    <table border="0" style="height: 100%; width: 100%;">
                      <tr>
                        <td align="center" colspan="2">
                          Complete
                        </td>
                      </tr>
                      <tr>
                        <td>
                          Your account has been successfully created.
                        </td>
                      </tr>
                      <tr>
                        <td align="right" colspan="2">
                          <asp:button runat="server" 
                            validationgroup="CreateUserWizard1" 
                            commandname="Continue"
                            id="ContinueButton" 
                            causesvalidation="False" 
                            text="Continue" />
                        </td>
                      </tr>
                    </table>
                  </td>
                </tr>
              </table>
            </contenttemplate>
          </asp:completewizardstep>
        </wizardsteps>
      </asp:createuserwizard>
    </form>
  </body>
</html>

Security noteSecurity Note:

This control has a text box that accepts user input, which is a potential security threat. User input in a Web page can potentially contain malicious client script. By default, ASP.NET Web pages validate user input to ensure that the input does not contain HTML elements or script. As long as this validation is enabled, you do not need to explicitly check for script or HTML elements in user input. For more information, see Script Exploits Overview (Visual Studio).

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.View
       System.Web.UI.WebControls.WizardStepBase
         System.Web.UI.WebControls.TemplatedWizardStep
          System.Web.UI.WebControls.CreateUserWizardStep
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.