Wizard.FinishNavigationTemplate Property


Gets or sets the template that is used to display the navigation area on the Finish step.

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

public virtual ITemplate FinishNavigationTemplate { get; set; }

Property Value

Type: System.Web.UI.ITemplate

The ITemplate that defines the content for the navigation area for the Finish on the Wizard. The default is null.

Use the FinishNavigationTemplate property to specify the custom content that is displayed for the navigation area on the Finish step of the Wizard control. Define the content by creating a template that specifies how the navigation area is rendered on the Finish step.

The custom content for the template is contained within the FinishNavigationTemplate object. You can add custom content to the FinishNavigationTemplate object either by using template-editing mode in design view or by defining the FinishNavigationTemplate 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 FinishNavigationTemplate object that is contained in the FinishNavigationTemplate property must contain two IButtonControl controls, one with its CommandName property set to "MoveComplete" and the other with its CommandName property set to "MovePrevious", to enable the navigation feature.

To access a control that is defined in a template programmatically, use the Controls collection of the Wizard object. You can also use the FindControl method of the Wizard object to find the control, if the control has an ID property specified.

The following code example demonstrates how to use the FinishNavigationTemplate property to create a custom template for the navigation area of the Finish step for the Wizard control.

System_CAPS_security 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 OnFinishButtonClick(object sender, EventArgs e)
    // Insert code here that determines if an email address was
    // entered in emailTextBox. Then send an confirmation email if it was.     


<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
    <form id="form1" 
      title="FinishNavigationTemplate Example" 
      <asp:Wizard ID="Wizard1" 
          <asp:WizardStep Runat="server" 
            Title="Step 1">
            <!-- Put UI elements for Step 1 here. -->
            This is step one.
          <asp:WizardStep Runat="server" 
            Title="Step 2">
            <!-- Put UI elements for Step 2 here. -->
            This is step two.
          <asp:WizardStep Runat="server" 
            The Wizard has been completed.
          Please enter your email address if you would like a confirmation email:
          <asp:TextBox ID="emailTextBox" 
          &nbsp;<br />
          <asp:Button CommandName="MovePrevious"
              Text="Previous" />
          <asp:Button CommandName="MoveComplete" 
            Text="Finish" />
          <b>FinishNavigationTemplate Example</b>

.NET Framework
Available since 2.0
Return to top