System.Web 2.0.0.0 System.Web.UI.WebControls.CompositeControl System.Web.UI.ToolboxData("<{0}:Wizard runat="server"> <WizardSteps> <asp:WizardStep title="Step 1" runat="server"></asp:WizardStep> <asp:WizardStep title="Step 2" runat="server"></asp:WizardStep> </WizardSteps> </{0}:Wizard>") System.ComponentModel.Designer("System.Web.UI.Design.WebControls.WizardDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner") System.ComponentModel.Bindable(false) System.ComponentModel.DefaultEvent("FinishButtonClick") In this topic: Introduction Wizard Components Wizard Steps Collecting Wizard Data Wizard Command Names Dynamically Changing Steps Wizard Appearance Formatting Using Layout Templates Accessibility Declarative Syntax

Introduction

You can use the control to: Collect related data across multiple steps. Break up a larger Web page used to collect user input into smaller logical steps. Allow for either linear or nonlinear navigation through the steps.

Wizard Components

The control is made up of the following components: A collection of steps that contain the user interface for each step, as defined by the page developer. Built-in navigation capabilities that determine the appropriate buttons to display based on the value. A header area that can be customized to display information specific to the step that the user is currently on. A sidebar area that can be used to quickly navigate to steps in the control. If you are using Microsoft Visual Studio 2005, note that the is persisted in Source view. If you change the property in Design view by clicking the sidebar buttons, and you then run the page, the first step of the Wizard control might not be shown because the might be pointing to a different step.

Wizard Steps

Each of the steps in the control has a property that determines the kind of navigation functionality that the step has. If you do not specify a value for the property, the default value is . The following table lists the available settings for the property and the resulting behavior of the step. WizardStepType.Auto The navigation UI that is rendered for the step is determined by the order in which the step is declared. WizardStepType.Complete The step is the last one to appear. No navigation buttons are rendered. WizardStepType.Finish The step is the last one that collects user data. The Finish button is rendered for navigation. WizardStepType.Start The step is the first one to appear. A Previous button is not rendered. WizardStepType.Step The step is any step between the first and last. Previous and Next buttons are rendered for navigation.

Collecting Wizard Data

Using the control, data can be collected through linear or nonlinear navigation. Some examples of nonlinear navigation are skipping unnecessary steps or returning to a previously completed step to change some value. The control maintains its state between steps, so the data entered on a step does not need to be persisted to a data store until all the steps of the control have been completed. Alternatively, if you want to persist the collected data to a data store as each step is completed, such as when the event is raised, you should set the property of the object to false so that the user cannot return to a previously completed step and change the data once it has been submitted.

Wizard Command Names

The control inherits the following command names from the class and class: , , , and . The Wizard control ignores these command names and does not include any special logic to enable these commands to automatically work for navigation. If a command name is removed or is missing from a button in the control, no exception is thrown. For example, if the button is missing a value for , no exception is thrown.

Dynamically Changing Steps

You can use the method or the property to dynamically change the step that is currently displayed in the control. If you programmatically add a in the Page_Load event handler, you must add the navigation to that step prior to the page loading.

Wizard Appearance

The appearance of the control is fully customizable through templates, skins, and style settings. For example, you can use the , , , , and properties to customize the interface of the control. Setting the , , , , , or property recreates the child controls of the control. As a result, the view state for the child controls is lost in the process. To avoid this situation, explicitly maintain the control state of the control's child controls explicitly, or avoid putting controls inside of templates. Note that the control does not support special Microsoft Internet Explorer rendering for non-standard or quirks mode. To get the best Internet Explorer rendering using the control, use the XHTML doc type, which is added by default in Visual Web Developer and Visual Studio.

Formatting Using Layout Templates

The control lets you specify the layout of the control without requiring you to use an HTML table element. Instead, you can use a LayoutTemplate element to specify the layout. In the template, you create placeholder controls to indicate where items should be dynamically inserted into the control. (This is similar to how the template model for the control works.) For more information, see the property.

Accessibility

For information about how to configure this control so that it generates markup that conforms to accessibility standards, see
Accessibility in Visual Studio 2010 and ASP.NET 4 and ASP.NET Controls and Accessibility.

Declarative Syntax

<asp:Wizard     AccessKey="string"     ActiveStepIndex="integer"     BackColor="color name|#dddddd"     BorderColor="color name|#dddddd"     BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge| Inset|Outset"     BorderWidth="size"     CancelButtonImageUrl="uri"     CancelButtonText="string"     CancelButtonType="Button|Image|Link"     CancelDestinationPageUrl="uri"     CellPadding="integer"     CellSpacing="integer"     CssClass="string"     DisplayCancelButton="True|False"     DisplaySideBar="True|False"     Enabled="True|False"     EnableTheming="True|False"     EnableViewState="True|False"     FinishCompleteButtonImageUrl="uri"     FinishCompleteButtonText="string"     FinishCompleteButtonType="Button|Image|Link"     FinishDestinationPageUrl="uri"     FinishPreviousButtonImageUrl="uri"     FinishPreviousButtonText="string"     FinishPreviousButtonType="Button|Image|Link"     Font-Bold="True|False"     Font-Italic="True|False"     Font-Names="string"     Font-Overline="True|False"     Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium| Large|X-Large|XX-Large"     Font-Strikeout="True|False"     Font-Underline="True|False"     ForeColor="color name|#dddddd"     HeaderText="string"     Height="size"     ID="string"     OnActiveStepChanged="ActiveStepChanged event handler"     OnCancelButtonClick="CancelButtonClick event handler"     OnDataBinding="DataBinding event handler"     OnDisposed="Disposed event handler"     OnFinishButtonClick="FinishButtonClick event handler"     OnInit="Init event handler"     OnLoad="Load event handler"     OnNextButtonClick="NextButtonClick event handler"     OnPreRender="PreRender event handler"     OnPreviousButtonClick="PreviousButtonClick event handler"     OnSideBarButtonClick="SideBarButtonClick event handler"     OnUnload="Unload event handler"     runat="server"     SkinID="string"     SkipLinkText="string"     StartNextButtonImageUrl="uri"     StartNextButtonText="string"     StartNextButtonType="Button|Image|Link"     StepNextButtonImageUrl="uri"     StepNextButtonText="string"     StepNextButtonType="Button|Image|Link"     StepPreviousButtonImageUrl="uri"     StepPreviousButtonText="string"     StepPreviousButtonType="Button|Image|Link"     Style="string"     TabIndex="integer"     ToolTip="string"     Visible="True|False"     Width="size" >         <CancelButtonStyle />         <FinishCompleteButtonStyle />         <FinishNavigationTemplate> <!-- child controls -->         </FinishNavigationTemplate>         <FinishPreviousButtonStyle />         <HeaderStyle />         <HeaderTemplate> <!-- child controls -->         </HeaderTemplate>         <NavigationButtonStyle />         <NavigationStyle />         <SideBarButtonStyle />         <SideBarStyle />         <SideBarTemplate> <!-- child controls -->         </SideBarTemplate>         <StartNavigationTemplate> <!-- child controls -->         </StartNavigationTemplate>         <StartNextButtonStyle />         <StepNavigationTemplate> <!-- child controls -->         </StepNavigationTemplate>         <StepNextButtonStyle />         <StepPreviousButtonStyle />         <StepStyle />         <WizardSteps>                 <asp:TemplatedWizardStep                     AllowReturn="True|False"                     ContentTemplateContainer="string"                     EnableTheming="True|False"                     EnableViewState="True|False"                     ID="string"                     OnActivate="Activate event handler"                     OnDataBinding="DataBinding event handler"                     OnDeactivate="Deactivate event handler"                     OnDisposed="Disposed event handler"                     OnInit="Init event handler"                     OnLoad="Load event handler"                     OnPreRender="PreRender event handler"                     OnUnload="Unload event handler"                     runat="server"                     SkinID="string"                     StepType="Auto|Complete|Finish|Start|Step"                     Title="string"                     Visible="True|False" >                         <ContentTemplate> <!-- child controls -->                         </ContentTemplate>                         <CustomNavigationTemplate> <!-- child controls -->                         </CustomNavigationTemplate>                 </asp:TemplatedWizardStep>                 <asp:WizardStep                     AllowReturn="True|False"                     EnableTheming="True|False"                     EnableViewState="True|False"                     ID="string"                     OnActivate="Activate event handler"                     OnDataBinding="DataBinding event handler"                     OnDeactivate="Deactivate event handler"                     OnDisposed="Disposed event handler"                     OnInit="Init event handler"                     OnLoad="Load event handler"                     OnPreRender="PreRender event handler"                     OnUnload="Unload event handler"                     runat="server"                     SkinID="string"                     StepType="Auto|Complete|Finish|Start|Step"                     Title="string"                     Visible="True|False"                 />         </WizardSteps> </asp:Wizard>
Provides navigation and a user interface (UI) to collect related data across multiple steps.
Constructor Use the constructor to create and initialize a new instance of the class. Initializes a new instance of the class. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden) System.Web.UI.WebControls.WizardStepBase To be added. The property returns the object that is currently displayed in the control. The property is read-only; however, you can use the property to access the properties of the current object. Use the property to dynamically change the to a different object. Alternatively, you can use the method to dynamically set the property. Gets the step in the collection that is currently displayed to the user. 2.0.0.0 Event System.EventHandler The event is raised when the current step that is displayed in the control changes. Use the event to provide additional processing when the current step of the control changes. For more information about handling events, see Consuming Events. Occurs when the user switches to a new step in the control. 2.0.0.0 Property System.Web.UI.Themeable(false) System.ComponentModel.DefaultValue(-1) System.Int32 To be added. The property provides the zero-based index of the object that is currently displayed in the control. You can programmatically set the property to control which step is displayed to the user at run time. If you are using Microsoft Visual Studio 2005, note that the is persisted in Source view. If you change the property in Design view by clicking the sidebar buttons, and you then run the page, the first step of the Wizard control might not be shown because the might be pointing to a different step. If you set the value of to -1 to support a wizard with no steps by default, the following behavior occurs: If you declaratively set to -1 or set it to -1 as a default value, the control will always try to render the first step in the wizard. If you programmatically set to -1, the control will not render. This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview. Gets or sets the index of the current object. 2.0.0.0 Method System.Boolean The method can be accessed from a derived class only because of its protected modifier. In a derived class, you can use the method to determine whether the index that is passed in can be used to set the property. The method will return false if the index that is passed in refers to a object that has already been accessed and has its property set to false; otherwise, it will return true. Uses a Boolean value to determine whether the property can be set to the object that corresponds to the index that is passed in. false if the index passed in refers to a that has already been accessed and its property is set to false; otherwise, true. The index of the object being checked. 2.0.0.0 Event System.EventHandler The event is raised when the Cancel button on the control is clicked. Use the event to provide additional processing when the Cancel button is clicked. For more information about handling events, see Consuming Events. Occurs when the Cancel button is clicked. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "CancelButton". Specifies the identifier for the Cancel button. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DefaultValue("") System.Web.UI.UrlProperty System.String To be added. When the property is set to , use the property to specify the image to display for the Cancel button. Gets or sets the URL of the image displayed for the Cancel button. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.Style To be added. The property defines the appearance for the Cancel button on the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the property. Any setting that is applied in the property overrides the corresponding setting in the property. Gets a reference to a collection of style properties that define the appearance of the Cancel button. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.String To be added. The property contains the text that is displayed for the Cancel button on the control. Depending on the value of the property, the property can appear as text on a button, as text displayed as an alternative to an image, or as the text of a link. The following table lists the values and their respective effects on the Cancel button text. Text appears on the button. Text appears as alternative text for the image. Text appears as a link. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text caption that is displayed for the Cancel button. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.ButtonType.Button) System.Web.UI.WebControls.ButtonType To be added. To be added. Gets or sets the type of button that is rendered as the Cancel button. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "Cancel". Retrieves the command name for the Cancel button. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.DefaultValue("") System.ComponentModel.Editor("System.Web.UI.Design.UrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.Web.UI.UrlProperty System.String To be added. The property specifies the step that is displayed when the user clicks the Cancel button on the control. If the property is set to true and the property is not set, the Web page is refreshed and the event is raised. This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview. Gets or sets the URL that the user is directed to when they click the Cancel button. 2.0.0.0 Property System.ComponentModel.DefaultValue(0) System.Int32 To be added. Use the property to control the spacing between the contents of a cell and the cell border. The padding amount that is specified is added to all four sides of the cell. All cells in a column share the same cell width; therefore, the spacing is applied to the widest cell in the column. Similarly, all cells in the same row share the same cell height. Thus, the spacing is applied to the tallest cell in the row. Individual cell sizes cannot be specified. Gets or sets the amount of space between the contents of the cell and the cell border. 2.0.0.0 Property System.ComponentModel.DefaultValue(0) System.Int32 To be added. Use the property to control the spacing between adjacent cells in a Wizard control. This spacing is applied both vertically and horizontally. Gets or sets the amount of space between cells. 2.0.0.0 Method 2.0.0.0 System.Void To be added. Creates child controls. Method System.Web.UI.ControlCollection To be added. To be added. Creates control collection. 2.0.0.0 Method System.Void To be added. Creates the hierarchy of child controls that make up the control. 2.0.0.0 Method System.Web.UI.WebControls.Style To be added. To be added. Creates control style. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "CustomFinishButton". Retrieves the identifier for a custom Finish button. This field is static and read-only. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "CustomNextButton". Retrieves the identifier for a custom Next button. This field is static and read-only. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "CustomPreviousButton". Retrieves the identifier for a custom Previous button. This field is static and read-only. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "SideBarList". Retrieves the identifier for the sidebar collection. This field is static and read-only. 2.0.0.0 Property System.Web.UI.Themeable(false) System.ComponentModel.DefaultValue(false) System.Boolean To be added. To be added. Gets or sets a Boolean value indicating whether to display a Cancel button. 2.0.0.0 Property System.Web.UI.Themeable(false) System.ComponentModel.DefaultValue(true) System.Boolean To be added. There can be a difference in the rendering of the control depending on whether this property is set to true or false. When this property value is set to true and the sidebar is displayed, cell spacing is not applied to the HeadCell, StepCell, or NavigationCell elements of the control's table. When this value is false, cell spacing is applied. This may affect how the control is rendered. Gets or sets a Boolean value indicating whether to display the sidebar area on the control. 2.0.0.0 Event System.Web.UI.WebControls.WizardNavigationEventHandler The event is raised when the Finish button on the control is clicked. Use the event to provide additional processing when the Finish button is clicked. For more information about handling events, see Consuming Events. Occurs when the Finish button is clicked. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "FinishButton". Retrieves the identifier for the Finish button. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DefaultValue("") System.Web.UI.UrlProperty System.String To be added. When the property is set to the field, use the property to specify the image to display for the Finish button. Gets or sets the URL of the image that is displayed for the Finish button. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.Style To be added. The property defines the appearance for the Finish button on the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the property. Any setting that is applied in the property overrides the corresponding setting in the property. Gets a reference to a object that defines the settings for the Finish button. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.String To be added. The property contains the text that is displayed for the Finish button on the control. Depending on the value of the property, the property can appear as text on a button, as text displayed as an alternative to an image in browsers that do not render images, or as the text of a link. The following table lists the field values for the property and the respective effect of each on the Finish button text. Text appears on the button. Text appears as alternative text for the image. Text appears as link text. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text caption that is displayed for the Finish button. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.ButtonType.Button) System.Web.UI.WebControls.ButtonType To be added. To be added. Gets or sets the type of button that is rendered as the Finish button. 2.0.0.0 Property System.ComponentModel.DefaultValue("") System.ComponentModel.Editor("System.Web.UI.Design.UrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.Web.UI.UrlProperty System.String To be added. The property specifies the step that is displayed when the user clicks the Finish button on the control. This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview. Gets or sets the URL that the user is redirected to when they click the Finish button. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Wizard), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. Use the property to specify the custom content that is displayed for the navigation area on the step of the control. Define the content by creating a template that specifies how the navigation area is rendered on the step. The custom content for the template is contained within the object. You can add custom content to the object either by using template-editing mode in design view or by defining the object inline using FinishNavigationTemplate tags. The content can be as simple as plain text or more complex (embedding other controls in the template, for example). The object that is contained in the property must contain two controls, one with its property set to "MoveComplete" and the other with its property set to "MovePrevious", to enable the navigation feature. To access a control that is defined in a template programmatically, use the collection of the object. You can also use the method of the object to find the control, if the control has an property specified. Gets or sets the template that is used to display the navigation area on the step. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the "FinishPreviousButton". Retrieves the identifier for the Previous button on the step. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DefaultValue("") System.Web.UI.UrlProperty System.String To be added. When the property is set to the field, use the property to specify the image to display for the Previous button on the step. Gets or sets the URL of the image that is displayed for the Previous button on the step. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.Style To be added. The property defines the appearance for the Previous button on the step of the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the property. Any setting that is applied in the property overrides the corresponding setting in the property. Gets a reference to a object that defines the settings for the Previous button on the step. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.String To be added. The property contains the text that is displayed for the Previous button on the step of the control. Depending on the value of the property, the property can appear as text on a button, as text displayed as an alternative to an image in browsers that do not render images, or as the text of a link. The following table lists the property field values and the respective effects on the Previous button text. Text appears on the button. Text appears as alternative text for the image. Text appears as a link. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text caption that is displayed for the Previous button on the step. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.ButtonType.Button) System.Web.UI.WebControls.ButtonType To be added. To be added. Gets or sets the type of button that is rendered as the Previous button on the step. 2.0.0.0 Method System.Collections.IDictionary To be added. To be added. Gets the design mode state. 2.0.0.0 Method System.Collections.ICollection The method returns a collection containing the objects that have been accessed. The objects are arranged in the order in which they were accessed: the first item in the collection is the previous object, the second item in the collection is the object that was accessed before the previous step, and so on. Returns a collection of objects that have been accessed. An containing the objects that have been accessed. 2.0.0.0 Method System.Web.UI.WebControls.WizardStepType Use the method to determine the value of the specified object. Returns the value for the specified object. One of the values. The for which the associated is returned. The index of the for which the associated is returned. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.TableItemStyle To be added. The property defines the appearance for the header area on the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. Gets a reference to a object that defines the settings for the header area on the control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Wizard), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. Use the property to specify the custom content that is displayed for the header area on a control. Define the content by creating a template that specifies how the header area is rendered. The custom content for the template is contained within the object. You can add custom content to the object either by using template-editing mode in design view or by defining the object inline using HeaderTemplate tags. The content can be as simple as plain text or more complex (embedding other controls in the template, for example). To access a control that is defined in a template programmatically, use the collection of the object. You can also use the method of the object to find the control, if the control has an property specified. Gets or sets the template that is used to display the header area on the control. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.ComponentModel.DefaultValue("") System.String To be added. The property defines the text caption that is displayed for the header area on the control. To control the style of the header area, use the property. Alternatively, you can define your own custom UI for the header row by setting the property instead of the property. If both the and properties are defined, the property has no effect. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text caption that is displayed for the header area on the control. 2.0.0.0 Method 2.0.0.0 System.Void To be added. To be added. Restores control state information. Method System.Void To be added. Loads view-state information. The control state to be restored. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "MoveComplete". Retrieves the command name that is associated with the Finish button. This field is static and read-only. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "MoveNext". Retrieves the command name that is associated with the Next button. This field is static and read-only. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "MovePrevious". Retrieves the command name that is associated with the Previous button. This field is static and read-only. 2.0.0.0 Method System.Void Use the method to control which -derived object is set as the value for the property in the control programmatically. This way, you can change the property dynamically based on other conditions during run time. Sets the specified -derived object as the value for the property of the control. The -derived object to set as the . 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "Move". Retrieves the command name that is associated with each of the sidebar buttons. This field is static and read-only. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.Style To be added. The property defines the appearance for the buttons in the navigation area on the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the individual button styles. Any setting that is applied in the individual button style properties overrides the corresponding setting in the property. For example, if you set the FinishPreviousButtonStyle.ForeColor property to "red" and the NavigationButtonStyle.ForeColor property to "green", the color for the button will be red because the individual style settings of the property override the settings of the property. The following property styles are overridden by individual button style settings: Gets a reference to a object that defines the settings for the buttons in the navigation area on the control. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.TableItemStyle To be added. The property defines the appearance for the navigation area on the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the control. Any settings that are applied in the property override the corresponding settings in the properties of the control. The following style properties are overridden by the settings: Gets a reference to a object that defines the settings for the navigation area on the control. 2.0.0.0 Event System.Web.UI.WebControls.WizardNavigationEventHandler The event is raised when the Next button on the control is clicked. Use the event to provide additional processing when the Next button is clicked. For more information about handling events, see Consuming Events. Occurs when the Next button is clicked. 2.0.0.0 Method System.Void The method raises the event when the property of the control is changed. Use the event to provide additional processing when the current step that is displayed in the control changes. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. The source of the event. An that contains the event data. 2.0.0.0 Method System.Boolean To be added. Determines whether the event for the server control is passed up the page’s user interface server control hierarchy. true if the event for the server control is passed up the page’s user interface server control hierarchy; otherwise, false. The source of the event. Contains event data. 2.0.0.0 Method System.Void The event is raised when the Cancel button is clicked. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. An containing the event data. 2.0.0.0 Method System.Void The event is raised when the Finish button is clicked. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A containing the event data. 2.0.0.0 Method 2.0.0.0 System.Void To be added. Raises the Init event. The raised event. Method System.Void The event is raised when the Next button is clicked. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A containing the event data. 2.0.0.0 Method System.Void The event is raised when the Previous button is clicked. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A containing event data. 2.0.0.0 Method System.Void The event is raised when a button on the sidebar area is clicked. The event does not raise an event if a control with the property set to Move is outside of the control's sidebar list for the object. Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class. Raises the event. A containing event data. 2.0.0.0 Event System.Web.UI.WebControls.WizardNavigationEventHandler The event is raised when the Previous button on the control is clicked. Use the event to provide additional processing when the Previous button is clicked. For more information about handling events, see Consuming Events. Occurs when the Previous button is clicked. 2.0.0.0 Method 2.0.0.0 System.Void To be added. Registers a new instance of the class for the specified object. The for which the new instance of is registered. Method 2.0.0.0 System.Void To be added. Renders the control to the specified writer. The HTML writer. Method 2.0.0.0 System.Object To be added. Save the control state. The control state. Method System.Object To be added. Saves the view state. The view state. 2.0.0.0 Event System.Web.UI.WebControls.WizardNavigationEventHandler The event is raised when a button in the sidebar area on the control is clicked. Use the event to provide additional processing when a button in the sidebar area is clicked. The event does not raise an event if a control with the property set to Move is outside of the control's sidebar list for the object. For more information about handling events, see Consuming Events. Occurs when a button in the sidebar area is clicked. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "SideBarButton". Retrieves the identifier that is associated with each of the sidebar buttons. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DefaultValue(null) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.Web.UI.WebControls.Style To be added. The property defines the appearance of the buttons on the sidebar of the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the control. Any settings that are applied in the property override the corresponding settings in the properties of the control. The following style properties are overridden by settings: However, when you use templates to define the appearance of the control sidebar, the property has no effect. Gets a reference to a object that defines the settings for the buttons on the sidebar. 2.0.0.0 Property System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DefaultValue(null) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.Web.UI.WebControls.TableItemStyle To be added. The property defines the appearance for the sidebar area on the control. The property is read-only; however, you can set the properties of the object it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the control. Any settings that are applied in the property override the corresponding settings in the properties of the control. The height property for is ignored if the height is set to less than the height of the wizard. Values set for height and height add to the total height of the wizard. For example, if the Wizard height is set to 500px and height or height is set to 50px or 10%, then the total wizard height is 550px. The following style properties are overridden by settings: Gets a reference to a object that defines the settings for the sidebar area on the control. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Wizard), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. Use the property to specify the custom content that is displayed for the sidebar area on a control. Define the content by creating a template that specifies how the sidebar area is rendered. The custom content for the template is contained within the object. You can add custom content to the object either by using template-editing mode in design view or by defining the object inline using SideBarTemplate tags. The content can be as simple as plain text or more complex (embedding other controls in the template, for example). The object must contain a control or control whose property is set to "SideBarList" to enable the sidebar navigation feature. Also, the "SideBarList" on the or control must contain an control. To access a control that is defined in a template programmatically, use the collection of the object. You can also use the method of the object to find the control, if the control has an property specified. Gets or sets the template that is used to display the sidebar area on the control. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.String To be added. Use the property to specify the alternate text for a hidden image that is read by screen readers to provide the ability to skip the content for a sidebar area. The text that you specify provides assistive technology devices with a description of the hidden image that can be used to make the control more accessible. If the property is set to false, the property does not create a hidden image with alternate text. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets a value that is used to render alternate text that notifies screen readers to skip the content in the sidebar area. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Wizard), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. Use the property to specify the custom content that is displayed for the navigation area on the step of the control. Define the content by creating a template that specifies how the navigation area is rendered on the step. The custom content for the template is contained within the object. You can add custom content to the object either by using template-editing mode in design view or by defining the object inline using StartNavigationTemplate tags. The content can be as simple as plain text or more complex (embedding other controls in the template, for example). The object that is contained in the property must contain an control with the property set to "MoveNext" to enable the navigation feature. To access a control that is defined in a template programmatically, use the collection of the object. You can also use the method of the object to find the control, if the control has an property specified. Gets or sets the template that is used to display the navigation area on the step of the control. 2.0.0.0 Field System.String The is used primarily by control developers. The value for the is "StartNextButton". Retrieves the identifier that is associated with the Next button on the step. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DefaultValue("") System.Web.UI.UrlProperty System.String To be added. When the property is set to the field, use the property to specify the image to display for the Next button. Gets or sets the URL of the image that is displayed for the Next button on the step. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.Style To be added. The property defines the appearance for the Next button on the step of the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the property. Any setting that is applied in the property overrides the corresponding setting in the property. Gets a reference to a object that defines the settings for the Next button on the step. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.String To be added. The property contains the text that is displayed for the Next button on the step of the control. Depending on the value of the property, the property can appear as text on a button, as text displayed as an alternative to an image in browsers that do not render images, or as the text of a link. The following table lists the field values for the property and the respective effect of each on the Next button text. Text appears on the button. Text appears as alternative text for the image. Text appears as a link. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text caption that is displayed for the Next button on the step. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.ButtonType.Button) System.Web.UI.WebControls.ButtonType To be added. To be added. Gets or sets the type of button that is rendered as the Next button on the step. 2.0.0.0 Property System.ComponentModel.Browsable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Wizard), System.ComponentModel.BindingDirection.OneWay) System.ComponentModel.DefaultValue(null) System.Web.UI.ITemplate To be added. Use the property to specify the custom content that is displayed for the navigation area on the step of the control. Define the content by creating a template that specifies how the navigation area is rendered on the step. The custom content for the template is contained within the object. You can add custom content to the object either by using template-editing mode in design view or by defining the object inline using StepNavigationTemplate tags. The content can be as simple as plain text or more complex (embedding other controls in the template, for example). The object that is contained in the property must contain two controls, one with its property set to "MoveNext" and one with its property set to "MovePrevious", to enable the navigation feature. To access a control that is defined in a template programmatically, use the collection of the object. You can also use the method of the object to find the control, if the control has an property specified. Gets or sets the template that is used to display the navigation area on any -derived objects other than the , the , or step. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "StepNextButton". Retrieves the identifier that is associated with the Next button. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DefaultValue("") System.Web.UI.UrlProperty System.String To be added. When the property is set to the field, use the property to specify the image to display for the Next button. Gets or sets the URL of the image that is displayed for the Next button. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.Style To be added. The property defines the appearance for the Next button on the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the property. Any setting that is applied in the property overrides the corresponding setting in the property. Gets a reference to the object that defines the settings for the Next button. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.String To be added. The property contains the text that is displayed for the Next button on the control. Depending on the value of the property, the property can appear as text on a button, as text displayed as an alternative to an image, or as the text of a link. The following table lists the field values for the property and the respective effect of each on the Next button text. Text appears on the button. Text appears as alternative text for the image. Text appears as a link. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text caption that is displayed for the Next button. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.ButtonType.Button) System.Web.UI.WebControls.ButtonType To be added. To be added. Gets or sets the type of button that is rendered as the Next button. 2.0.0.0 Field System.String The field is used primarily by control developers. The value for the is "StepPreviousButton". Retrieves the identifier that is associated with the Previous button. This field is static and read-only. 2.0.0.0 Property System.ComponentModel.Editor("System.Web.UI.Design.ImageUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DefaultValue("") System.Web.UI.UrlProperty System.String To be added. When the property is set to the field, use the property to specify the image to display for the Previous button. Gets or sets the URL of the image that is displayed for the Previous button. 2.0.0.0 Property System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.ComponentModel.DefaultValue(null) System.Web.UI.WebControls.Style To be added. The property defines the appearance of the Previous button on a step for the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the property. Any setting that is applied in the property overrides the corresponding setting in the property. Gets a reference to a object that defines the settings for the Previous button. 2.0.0.0 Property System.ComponentModel.Localizable(true) System.String To be added. The property contains the text that is displayed for the Previous button on the control. Depending on the value of the property, the property can appear as text on a button, as text displayed as an alternative to an image in browsers that do not render images, or as the text of a link. The following table lists the field values for the property and the respective effect of each on the Previous button text. Text appears on the button. Text appears as alternative text for the image. Text appears as a link. The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see and ASP.NET Globalization and Localization. Gets or sets the text caption that is displayed for the Previous button. 2.0.0.0 Property System.ComponentModel.DefaultValue(System.Web.UI.WebControls.ButtonType.Button) System.Web.UI.WebControls.ButtonType To be added. To be added. Gets or sets the type of button that is rendered as the Previous button. 2.0.0.0 Property System.ComponentModel.NotifyParentProperty(true) System.ComponentModel.DefaultValue(null) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.Web.UI.WebControls.TableItemStyle To be added. The property gets a reference to a object that defines the appearance for the objects on the control. The property is read-only; however, you can set the properties of the object that it returns. You can set these properties declaratively in the form Property-Subproperty, where represents a property of the class (for example, CancelButtonStyle-ForeColor). You can set a property programmatically in the form Property.Subproperty (for example, CancelButtonStyle.ForeColor). Common settings include custom background color, text color, and font properties. The style settings for the property are merged with the style settings for the property of the control. Any setting that is applied in the property overrides the corresponding setting in the property of the control. The following properties can be set to override the properties of the control: When you use a template to define the appearance for the objects, the property has no effect. Gets a reference to a object that defines the settings for the objects. 2.0.0.0 Property System.Web.UI.HtmlTextWriterTag To be added. The property is used primarily by control developers to extend the control. Gets the value that corresponds to the control. 2.0.0.0 Method System.Void To be added. Tracks view state. 2.0.0.0 Property System.Web.UI.Themeable(false) System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty) System.ComponentModel.Editor("System.Web.UI.Design.WebControls.WizardStepCollectionEditor,System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content) System.Web.UI.WebControls.WizardStepCollection To be added. The property returns a collection of objects that make up the control. You can use the collection to access the objects that are contained in the control programmatically. Use the , , , and methods to manipulate the objects in the collection programmatically. If you are using Microsoft Visual Studio 2005, note that the is persisted in Source view. If you change the property in Design view by clicking the sidebar buttons, and you then run the page, the first step of the Wizard control might not be shown because the might be pointing to a different step. If the control contains multiple collections, the collections will be merged. This property cannot be set by themes or style sheet themes. For more information, see and ASP.NET Themes Overview. Gets a collection containing all the objects that are defined for the control. 2.0.0.0