CreateUserWizardStep Class
Contains basic functionality for creating a user in a step that can be templated. This class cannot be inherited.
System.Web.UI.Control
System.Web.UI.WebControls.View
System.Web.UI.WebControls.WizardStepBase
System.Web.UI.WebControls.TemplatedWizardStep
System.Web.UI.WebControls.CreateUserWizardStep
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
The CreateUserWizardStep type exposes the following members.
| Name | Description | |
|---|---|---|
 | AllowReturn | Gets 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.) |
| AppRelativeTemplateSourceDirectory | Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (Inherited from Control.) |
| BindingContainer | Infrastructure. Gets the control that contains this control's data binding. (Inherited from Control.) |
| ClientID | Gets the control ID for HTML markup that is generated by ASP.NET. (Inherited from Control.) |
| ClientIDMode | Gets or sets the algorithm that is used to generate the value of the ClientID property. (Inherited from Control.) |
| ContentTemplate | Gets or sets the template for displaying the content of a step in a Wizard control. (Inherited from TemplatedWizardStep.) |
| ContentTemplateContainer | Gets the container that a Wizard control uses to create a ContentTemplate template for a step. (Inherited from TemplatedWizardStep.) |
| Context | Gets the HttpContext object associated with the server control for the current Web request. (Inherited from Control.) |
| Controls | Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Inherited from Control.) |
| CustomNavigationTemplate | Gets or sets the template for displaying the navigation user interface (UI) of a step in a Wizard control. (Inherited from TemplatedWizardStep.) |
| CustomNavigationTemplateContainer | Gets the container that a Wizard control uses to create a CustomNavigationTemplate template for a step. (Inherited from TemplatedWizardStep.) |
| DataItemContainer | Gets a reference to the naming container if the naming container implements IDataItemContainer. (Inherited from Control.) |
| DataKeysContainer | Gets a reference to the naming container if the naming container implements IDataKeysControl. (Inherited from Control.) |
| DesignMode | Gets a value indicating whether a control is being used on a design surface. (Inherited from Control.) |
| EnableTheming | Gets or sets a value indicating whether themes apply to this control. (Inherited from WizardStepBase.) |
| EnableViewState | Gets 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.) |
| ID | Gets or sets the programmatic identifier assigned to the server control. (Inherited from WizardStepBase.) |
| IsChildControlStateCleared | Gets a value indicating whether controls contained within this control have control state. (Inherited from Control.) |
| IsViewStateEnabled | Gets a value indicating whether view state is enabled for this control. (Inherited from Control.) |
| Name | Gets the name associated with a step in a control that acts as a wizard. (Inherited from WizardStepBase.) |
| NamingContainer | Gets 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.) |
| Page | Gets a reference to the Page instance that contains the server control. (Inherited from Control.) |
| Parent | Gets a reference to the server control's parent control in the page control hierarchy. (Inherited from Control.) |
| RenderingCompatibility | Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Inherited from Control.) |
| Site | Gets information about the container that hosts the current control when rendered on a design surface. (Inherited from Control.) |
| SkinID | Gets the skin to apply to the TemplatedWizardStep. (Inherited from TemplatedWizardStep.) |
| StepType | Gets or sets the type of user interface (UI) to display for the CreateUserWizardStep step of a CreateUserWizard control. (Overrides WizardStepBase.StepType.) |
| TemplateControl | Gets or sets a reference to the template that contains this control. (Inherited from Control.) |
| TemplateSourceDirectory | Gets the virtual directory of the Page or UserControl that contains the current server control. (Inherited from Control.) |
| Title | Gets or sets the title to use for the user-account-creation step of the CreateUserWizard control. (Overrides WizardStepBase.Title.) |
| UniqueID | Gets the unique, hierarchically qualified identifier for the server control. (Inherited from Control.) |
| ValidateRequestMode | Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (Inherited from Control.) |
| ViewStateMode | Gets or sets the view-state mode of this control. (Inherited from Control.) |
| Visible | Gets or sets a value that indicates whether the View control is visible. (Inherited from View.) |
| Wizard | Gets the Wizard control that is the parent of the object derived from WizardStepBase. (Inherited from WizardStepBase.) |
| Name | Description | |
|---|---|---|
| AddedControl | Called after a child control is added to the Controls collection of the Control object. (Inherited from Control.) |
| ApplyStyleSheetSkin | Applies the style properties defined in the page style sheet to the control. (Inherited from Control.) |
| CreateChildControls | Called 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.) |
| DataBind() | Binds a data source to the invoked server control and all its child controls. (Inherited from Control.) |
| Dispose | Enables a server control to perform final clean up before it is released from memory. (Inherited from Control.) |
| Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
| FindControl(String) | Searches the current naming container for a server control with the specified id parameter. (Inherited from Control.) |
| Focus | Sets input focus to a control. (Inherited from Control.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetRouteUrl(Object) | Gets the URL that corresponds to a set of route parameters. (Inherited from Control.) |
| GetRouteUrl(RouteValueDictionary) | Gets the URL that corresponds to a set of route parameters. (Inherited from Control.) |
| GetRouteUrl(String, Object) | Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.) |
| GetRouteUrl(String, RouteValueDictionary) | Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetUniqueIDRelativeTo | Returns the prefixed portion of the UniqueID property of the specified control. (Inherited from Control.) |
| HasControls | Determines if the server control contains any child controls. (Inherited from Control.) |
| LoadControlState | Restores control-state information from a previous page request that was saved by the SaveControlState method. (Inherited from Control.) |
| MapPathSecure | Retrieves the physical path that a virtual path, either absolute or relative, maps to. (Inherited from Control.) |
| OnActivate | Raises the Activate event of the View control. (Inherited from View.) |
| OnDeactivate | Raises the Deactivate event of the View control. (Inherited from View.) |
| OnInit | Raises the Init event. (Inherited from Control.) |
| OnLoad | Infrastructure. Raises the OnLoad event. (Inherited from WizardStepBase.) |
| OnPreRender | Raises the PreRender event. (Inherited from Control.) |
| OnUnload | Raises the Unload event. (Inherited from Control.) |
| OpenFile | Gets a Stream used to read a file. (Inherited from Control.) |
| RemovedControl | Called after a child control is removed from the Controls collection of the Control object. (Inherited from Control.) |
| Render | Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.) |
| RenderChildren | Outputs 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.) |
| RenderControl(HtmlTextWriter) | Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (Inherited from Control.) |
| ResolveClientUrl | Gets a URL that can be used by the browser. (Inherited from Control.) |
| ResolveUrl | Converts a URL into one that is usable on the requesting client. (Inherited from Control.) |
| SaveControlState | Saves any server control state changes that have occurred since the time the page was posted back to the server. (Inherited from Control.) |
| SetRenderMethodDelegate | Infrastructure. Assigns an event handler delegate to render the server control and its content into its parent control. (Inherited from Control.) |
| SetTraceData(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.) |
| SetTraceData(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.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
| Activate | Occurs when the current View control becomes the active view. (Inherited from View.) |
| DataBinding | Occurs when the server control binds to a data source. (Inherited from Control.) |
| Deactivate | Occurs when the current active View control becomes inactive. (Inherited from View.) |
| Disposed | Occurs 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.) |
| Init | Occurs when the server control is initialized, which is the first step in its lifecycle. (Inherited from Control.) |
| Load | Occurs when the server control is loaded into the Page object. (Inherited from Control.) |
| PreRender | Occurs after the Control object is loaded but prior to rendering. (Inherited from Control.) |
| Unload | Occurs when the server control is unloaded from memory. (Inherited from Control.) |
| Name | Description | |
|---|---|---|
| FindDataSourceControl | Returns the data source that is associated with the data control for the specified control. (Defined by DynamicDataExtensions.) |
| FindFieldTemplate | Returns the field template for the specified column in the specified control's naming container. (Defined by DynamicDataExtensions.) |
| FindMetaTable | Returns the metatable object for the containing data control. (Defined by DynamicDataExtensions.) |
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. |
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 |
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 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 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 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. |
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.
