Export (0) Print
Expand All

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)

[BrowsableAttribute(false)]
public sealed class CreateUserWizardStep : TemplatedWizardStep
<asp:CreateUserWizardStep />

The CreateUserWizardStep type exposes the following members.

  NameDescription
Public methodCreateUserWizardStepCreates a new instance of the CreateUserWizardStep control.
Top

  NameDescription
Public propertyAllowReturnGets or sets a value indicating whether the user is allowed to return to the current step from a subsequent step in a CreateUserWizard control. (Overrides WizardStepBase.AllowReturn.)
Public propertyAppRelativeTemplateSourceDirectoryGets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (Inherited from Control.)
Public propertyBindingContainerInfrastructure. Gets the control that contains this control's data binding. (Inherited from Control.)
Public propertyClientIDGets the control ID for HTML markup that is generated by ASP.NET. (Inherited from Control.)
Public propertyClientIDModeGets or sets the algorithm that is used to generate the value of the ClientID property. (Inherited from Control.)
Public propertyContentTemplateGets or sets the template for displaying the content of a step in a Wizard control. (Inherited from TemplatedWizardStep.)
Public propertyContentTemplateContainerGets the container that a Wizard control uses to create a ContentTemplate template for a step. (Inherited from TemplatedWizardStep.)
Protected propertyContextGets the HttpContext object associated with the server control for the current Web request. (Inherited from Control.)
Public propertyControlsGets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Inherited from Control.)
Public propertyCustomNavigationTemplateGets or sets the template for displaying the navigation user interface (UI) of a step in a Wizard control. (Inherited from TemplatedWizardStep.)
Public propertyCustomNavigationTemplateContainerGets the container that a Wizard control uses to create a CustomNavigationTemplate template for a step. (Inherited from TemplatedWizardStep.)
Public propertyDataItemContainerGets a reference to the naming container if the naming container implements IDataItemContainer. (Inherited from Control.)
Public propertyDataKeysContainerGets a reference to the naming container if the naming container implements IDataKeysControl. (Inherited from Control.)
Protected propertyDesignModeGets a value indicating whether a control is being used on a design surface. (Inherited from Control.)
Public propertyEnableThemingGets or sets a value indicating whether themes apply to this control. (Inherited from WizardStepBase.)
Public propertyEnableViewStateGets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (Inherited from Control.)
Public propertyIDGets or sets the programmatic identifier assigned to the server control. (Inherited from WizardStepBase.)
Protected propertyIsChildControlStateClearedGets a value indicating whether controls contained within this control have control state. (Inherited from Control.)
Protected propertyIsViewStateEnabledGets a value indicating whether view state is enabled for this control. (Inherited from Control.)
Public propertyNameGets the name associated with a step in a control that acts as a wizard. (Inherited from WizardStepBase.)
Public propertyNamingContainerGets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same Control.ID property value. (Inherited from Control.)
Public propertyPageGets a reference to the Page instance that contains the server control. (Inherited from Control.)
Public propertyParentGets a reference to the server control's parent control in the page control hierarchy. (Inherited from Control.)
Public propertyRenderingCompatibilityGets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Inherited from Control.)
Public propertySiteGets information about the container that hosts the current control when rendered on a design surface. (Inherited from Control.)
Public propertySkinIDGets the skin to apply to the TemplatedWizardStep. (Inherited from TemplatedWizardStep.)
Public propertyStepTypeGets or sets the type of user interface (UI) to display for the CreateUserWizardStep step of a CreateUserWizard control. (Overrides WizardStepBase.StepType.)
Public propertyTemplateControlGets or sets a reference to the template that contains this control. (Inherited from Control.)
Public propertyTemplateSourceDirectoryGets the virtual directory of the Page or UserControl that contains the current server control. (Inherited from Control.)
Public propertyTitleGets or sets the title to use for the user-account-creation step of the CreateUserWizard control. (Overrides WizardStepBase.Title.)
Public propertyUniqueIDGets the unique, hierarchically qualified identifier for the server control. (Inherited from Control.)
Public propertyValidateRequestModeGets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (Inherited from Control.)
Public propertyViewStateModeGets or sets the view-state mode of this control. (Inherited from Control.)
Public propertyVisibleGets or sets a value that indicates whether the View control is visible. (Inherited from View.)
Public propertyWizardGets the Wizard control that is the parent of the object derived from WizardStepBase. (Inherited from WizardStepBase.)
Top

  NameDescription
Protected methodAddedControlCalled after a child control is added to the Controls collection of the Control object. (Inherited from Control.)
Public methodApplyStyleSheetSkinApplies the style properties defined in the page style sheet to the control. (Inherited from Control.)
Protected methodCreateChildControlsCalled by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (Inherited from Control.)
Public methodDataBind()Binds a data source to the invoked server control and all its child controls. (Inherited from Control.)
Public methodDisposeEnables a server control to perform final clean up before it is released from memory. (Inherited from Control.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodFindControl(String)Searches the current naming container for a server control with the specified id parameter. (Inherited from Control.)
Public methodFocusSets input focus to a control. (Inherited from Control.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetRouteUrl(Object)Gets the URL that corresponds to a set of route parameters. (Inherited from Control.)
Public methodGetRouteUrl(RouteValueDictionary)Gets the URL that corresponds to a set of route parameters. (Inherited from Control.)
Public methodGetRouteUrl(String, Object)Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.)
Public methodGetRouteUrl(String, RouteValueDictionary)Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodGetUniqueIDRelativeToReturns the prefixed portion of the UniqueID property of the specified control. (Inherited from Control.)
Public methodHasControlsDetermines if the server control contains any child controls. (Inherited from Control.)
Protected methodLoadControlStateRestores control-state information from a previous page request that was saved by the SaveControlState method. (Inherited from Control.)
Protected methodMapPathSecureRetrieves the physical path that a virtual path, either absolute or relative, maps to. (Inherited from Control.)
Protected methodOnActivateRaises the Activate event of the View control. (Inherited from View.)
Protected methodOnDeactivateRaises the Deactivate event of the View control. (Inherited from View.)
Protected methodOnInitRaises the Init event. (Inherited from Control.)
Protected methodOnLoadInfrastructure. Raises the OnLoad event. (Inherited from WizardStepBase.)
Protected methodOnPreRenderRaises the PreRender event. (Inherited from Control.)
Protected methodOnUnloadRaises the Unload event. (Inherited from Control.)
Protected methodOpenFileGets a Stream used to read a file. (Inherited from Control.)
Protected methodRemovedControlCalled after a child control is removed from the Controls collection of the Control object. (Inherited from Control.)
Protected methodRenderSends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.)
Protected methodRenderChildrenOutputs the content of the WizardStepBase control's child controls to the specified HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from WizardStepBase.)
Public methodRenderControl(HtmlTextWriter)Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (Inherited from Control.)
Public methodResolveClientUrlGets a URL that can be used by the browser. (Inherited from Control.)
Public methodResolveUrlConverts a URL into one that is usable on the requesting client. (Inherited from Control.)
Protected methodSaveControlStateSaves any server control state changes that have occurred since the time the page was posted back to the server. (Inherited from Control.)
Public methodSetRenderMethodDelegateInfrastructure. Assigns an event handler delegate to render the server control and its content into its parent control. (Inherited from Control.)
Public methodSetTraceData(Object, Object)Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value. (Inherited from Control.)
Public methodSetTraceData(Object, Object, Object)Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value. (Inherited from Control.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public eventActivateOccurs when the current View control becomes the active view. (Inherited from View.)
Public eventDataBindingOccurs when the server control binds to a data source. (Inherited from Control.)
Public eventDeactivateOccurs when the current active View control becomes inactive. (Inherited from View.)
Public eventDisposedOccurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested. (Inherited from Control.)
Public eventInitOccurs when the server control is initialized, which is the first step in its lifecycle. (Inherited from Control.)
Public eventLoadOccurs when the server control is loaded into the Page object. (Inherited from Control.)
Public eventPreRenderOccurs after the Control object is loaded but prior to rendering. (Inherited from Control.)
Public eventUnloadOccurs when the server control is unloaded from memory. (Inherited from Control.)
Top

  NameDescription
Public Extension MethodFindDataSourceControlReturns the data source that is associated with the data control for the specified control. (Defined by DynamicDataExtensions.)
Public Extension MethodFindFieldTemplateReturns the field template for the specified column in the specified control's naming container. (Defined by DynamicDataExtensions.)
Public Extension MethodFindMetaTableReturns the metatable object for the containing data control. (Defined by DynamicDataExtensions.)
Top

  NameDescription
Explicit interface implemetationPrivate propertyIControlBuilderAccessor.ControlBuilderFor a description of this member, see IControlBuilderAccessor.ControlBuilder. (Inherited from Control.)
Explicit interface implemetationPrivate methodIControlDesignerAccessor.GetDesignModeStateFor a description of this member, see IControlDesignerAccessor.GetDesignModeState. (Inherited from Control.)
Explicit interface implemetationPrivate methodIControlDesignerAccessor.SetDesignModeStateFor a description of this member, see IControlDesignerAccessor.SetDesignModeState. (Inherited from Control.)
Explicit interface implemetationPrivate methodIControlDesignerAccessor.SetOwnerControlInfrastructure. For a description of this member, see IControlDesignerAccessor.SetOwnerControl. (Inherited from Control.)
Explicit interface implemetationPrivate propertyIControlDesignerAccessor.UserDataFor a description of this member, see IControlDesignerAccessor.UserData. (Inherited from Control.)
Explicit interface implemetationPrivate propertyIDataBindingsAccessor.DataBindingsFor a description of this member, see IDataBindingsAccessor.DataBindings. (Inherited from Control.)
Explicit interface implemetationPrivate propertyIDataBindingsAccessor.HasDataBindingsFor a description of this member, see IDataBindingsAccessor.HasDataBindings. (Inherited from Control.)
Explicit interface implemetationPrivate propertyIExpressionsAccessor.ExpressionsFor a description of this member, see IExpressionsAccessor.Expressions. (Inherited from Control.)
Explicit interface implemetationPrivate propertyIExpressionsAccessor.HasExpressionsFor a description of this member, see IExpressionsAccessor.HasExpressions. (Inherited from Control.)
Explicit interface implemetationPrivate methodIParserAccessor.AddParsedSubObjectFor a description of this member, see IParserAccessor.AddParsedSubObject. (Inherited from Control.)
Top

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.

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

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.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

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