Sdílet prostřednictvím

CatalogZoneBase.HeaderText Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá nebo nastaví text pro oblast záhlaví zóny.

public:
 virtual property System::String ^ HeaderText { System::String ^ get(); void set(System::String ^ value); };
public override string HeaderText { get; set; }
member this.HeaderText : string with get, set
Public Overrides Property HeaderText As String

Hodnota vlastnosti

String

Řetězec, který obsahuje text záhlaví zóny. Rozhraní .NET Framework poskytuje výchozí řetězec specifický pro jazykovou verzi.

Příklady

Následující příklad kódu ukazuje, jak použít HeaderText vlastnost deklarativně a programově. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v přehledu CatalogZoneBase třídy.

Všimněte si, že příklad kódu deklaruje dva <asp:catalogzone> prvky. Druhý deklaruje žádné CatalogPart ovládací prvky, ale oba deklarují hodnotu vlastnosti HeaderText .

<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."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<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."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

V druhé části příkladu kódu je hodnota HeaderText vlastnosti v první zóně programově přiřazena k jiné hodnotě.

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";
}

Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  CatalogZone1.SelectTargetZoneText = "Add to zone"
  CatalogZone1.EmptyZoneText = "Zone is empty"
  CatalogZone1.HeaderText = "My Updated Header"
  CatalogZone1.InstructionText = "My Updated Instructions"
End Sub

Když stránku načtete v prohlížeči, můžete výběrem možnosti Katalog z rozevíracího seznamu přepnout do režimu zobrazení katalogu. Když je katalog viditelný, všimněte si hodnot jednotlivých HeaderText vlastností zobrazených v oblasti záhlaví každé zóny. Můžete kliknout na tlačítko Nastavit vlastnosti textu zóny a HeaderText vlastnost horní zóny se nastaví na hodnotu přiřazenou v kódu.

Poznámky

Řetězcová hodnota HeaderText vlastnosti se zobrazí v oblasti CatalogZoneBase záhlaví zóny, která je na samém vrcholu zóny. Text vlastnosti se zobrazí, HeaderText když stránka přejde do režimu katalogu a uživatelské rozhraní katalogu se zobrazí.

Platí pro

Viz také