Wizard.HeaderText Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the text caption that is displayed for the header area on the control.

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

[LocalizableAttribute(true)] 
public virtual string HeaderText { get; set; }
/** @property */
public String get_HeaderText ()

/** @property */
public void set_HeaderText (String value)

public function get HeaderText () : String

public function set HeaderText (value : String)

Property Value

The text caption displayed for the header area on the Wizard. The default is an empty string ("").

The HeaderText property defines the text caption that is displayed for the header area on the Wizard control.

To control the style of the header area, use the HeaderStyle property. Alternatively, you can define your own custom UI for the header row by setting the HeaderTemplate property instead of the HeaderText property.

NoteNote

If both the HeaderText and HeaderTemplate properties are defined, the HeaderText 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 LocalizableAttribute and ASP.NET Globalization and Localization.

The following code example demonstrates how to use the ActiveStepChanged event to update the HeaderText property of the Wizard 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">

  void OnActiveStepChanged(object sender, EventArgs e)
  {
    // Every time that the ActiveStep property changes, change the HeaderText to match it.
    Wizard1.HeaderText = "You are currently on " + Wizard1.ActiveStep.Title;
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <body>
      <form id="form1" runat="server">
        <asp:Wizard ID="Wizard1" 
          Runat="server" 
          OnActiveStepChanged="OnActiveStepChanged" 
          HeaderText="ActiveStepChanged Example">
          <WizardSteps>
            <asp:WizardStep Title="Step 1" 
              Runat="server">
            </asp:WizardStep>
            <asp:WizardStep Title="Step 2" 
              Runat="server">
            </asp:WizardStep>
          </WizardSteps>
        </asp:Wizard>
      </form>
  </body>
</html>

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

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

.NET Framework

Supported in: 2.0
Show: