CatalogZoneBase.HeaderText Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft den Text für den Headerbereich einer Zone ab oder legt ihn fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die den Headertext für die Zone enthält. Eine kulturspezifische Standardzeichenfolge wird von .NET Framework bereitgestellt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die HeaderText Eigenschaft deklarativ und programmgesteuert verwendet wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der CatalogZoneBase Klassenübersicht.

Beachten Sie, dass im Codebeispiel zwei <asp:catalogzone> Elemente deklariert werden. Das zweite deklarieren keine CatalogPart Steuerelemente, aber beide deklarieren einen Wert für die HeaderText -Eigenschaft.

<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." />

Im zweiten Teil des Codebeispiels wird der Wert der HeaderText -Eigenschaft in der ersten Zone programmgesteuert einem anderen Wert zugewiesen.

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

Wenn Sie die Seite in einem Browser laden, können Sie in der Dropdownliste Katalog auswählen, um in den Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, beachten Sie die Werte jeder HeaderText Eigenschaft, die im Headerbereich jeder Zone angezeigt werden. Sie können auf die Schaltfläche Zonentexteigenschaften festlegen klicken, und die HeaderText Eigenschaft der oberen Zone wird auf den Wert festgelegt, der ihr im Code zugewiesen ist.

Hinweise

Der Zeichenfolgenwert der HeaderText -Eigenschaft wird im Headerbereich einer CatalogZoneBase Zone angezeigt, der sich ganz oben in der Zone befindet. Der Text der HeaderText -Eigenschaft wird angezeigt, wenn eine Seite in den Katalogmodus wechselt und die Benutzeroberfläche des Katalogs sichtbar wird.

Gilt für:

Weitere Informationen