This documentation is archived and is not being maintained.

CatalogZoneBase.HeaderText Property

Gets or sets the text for the header area of a zone.

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

public override string HeaderText { get; set; }
/** @property */
public String get_HeaderText ()

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

public override function get HeaderText () : String

public override function set HeaderText (value : String)

Not applicable.

Property Value

A string that contains the header text for the zone. A default culture-specific string is supplied by the .NET Framework.

The string value of the HeaderText property is displayed in the header area of a CatalogZoneBase zone, which is at the very top of the zone. The text of the HeaderText property is displayed when a page enters catalog mode and the catalog user interface (UI) becomes visible.

The following code example demonstrates how to use the HeaderText property declaratively and programmatically. For the full code required to run the example, see the Example section of the CatalogZoneBase class overview.

Notice that the code example declares two <asp:catalogzone> elements. The second one does not declare any CatalogPart controls, but both declare a value for the HeaderText property.

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
          title = "Text Content WebPart" 
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

In the second part of the code example, the value of the HeaderText property in the first zone is programmatically assigned to a different value.

protected void Button3_Click(object sender, EventArgs e)
  CatalogZone1.SelectTargetZoneText = "Add to zone";
  CatalogZone1.EmptyZoneText = "Zone is empty";
  CatalogZone1.HeaderText = "My Updated Header";
  CatalogZone1.InstructionText = "My Updated Instructions";

When you load the page in a browser, you can select Catalog from the drop-down list to switch to catalog display mode. When the catalog is visible, notice the values of each HeaderText property displayed in the header area of each zone. You can click the Set Zone Text Properties button, and the HeaderText property of the upper zone is set to the value assigned to it in the code.

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0