CreateUserWizardStep Class (System.Web.UI.WebControls)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

CreateUserWizardStep Class

Updated: November 2007

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)

Syntax

Visual Basic (Declaration)

<BrowsableAttribute(False)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CreateUserWizardStep _
    Inherits TemplatedWizardStep

Visual Basic (Usage)

Dim instance As CreateUserWizardStep

[BrowsableAttribute(false)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class CreateUserWizardStep : TemplatedWizardStep

Visual C++

[BrowsableAttribute(false)]
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class CreateUserWizardStep sealed : public TemplatedWizardStep

/** @attribute BrowsableAttribute(false) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public final class CreateUserWizardStep extends TemplatedWizardStep

JScript

public final class CreateUserWizardStep extends TemplatedWizardStep

ASP.NET

<asp:CreateUserWizardStep />

Remarks

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.

Note:
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.

Note:

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.

Topic	Location
How to: Customize the ASP.NET CreateUserWizard Control	Building ASP .NET Web Applications
How to: Customize the ASP.NET CreateUserWizard Control	Building ASP .NET Web Applications
How to: Customize the ASP.NET CreateUserWizard Control	Building ASP .NET Web Applications in Visual Studio

Examples

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.

<system.web>

</properties>

</profile>

</system.web>

</configuration>

Security 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 Basic

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

  Sub CreateUserWizard1_CreatedUser(ByVal sender As Object, ByVal e As System.EventArgs)
    Profile.SetPropertyValue("userName", firstName.Text & " " & lastName.Text)
  End Sub
</script>
<html  >
  <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>

<%@ 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  >
  <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 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.

Security 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.

The second code example lists the complete CreateUserWizardStep control.

Visual Basic

<%@ page language="VB"%>

<!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  >
  <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>

<%@ 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  >
  <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 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.

Security Note:

Permissions

AspNetHostingPermission
for operating in a hosted environment. Demand value: LinkDemand. Permission value: Minimal.
AspNetHostingPermission
for operating in a hosted environment. Demand value: InheritanceDemand. Permission value: Minimal.

Inheritance Hierarchy

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information