CatalogZoneBase.HeaderText Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ottiene o imposta il testo dell'area di intestazione di un'area.

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

Valore della proprietà

String

Stringa che contiene il testo dell'intestazione per l'area. Una stringa specifica delle impostazioni cultura predefinita viene fornita da .NET Framework.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la HeaderText proprietà dichiarativamente e a livello di codice. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio della panoramica della CatalogZoneBase classe.

Si noti che l'esempio di codice dichiara due <asp:catalogzone> elementi. Il secondo non dichiara alcun controllo, ma entrambi dichiarano CatalogPart un valore per la HeaderText proprietà.

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

Nella seconda parte dell'esempio di codice il valore della HeaderText proprietà nella prima zona viene assegnato a livello di codice a un valore diverso.

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

Quando si carica la pagina in un browser, è possibile selezionare Catalogo dall'elenco a discesa per passare alla modalità di visualizzazione del catalogo. Quando il catalogo è visibile, notare i valori di ogni HeaderText proprietà visualizzata nell'area di intestazione di ogni zona. È possibile fare clic sul pulsante Imposta proprietà testo zona e la HeaderText proprietà della zona superiore è impostata sul valore assegnato nel codice.

Commenti

Il valore stringa della HeaderText proprietà viene visualizzato nell'area di intestazione di una CatalogZoneBase zona, che si trova nella parte superiore della zona. Il testo della HeaderText proprietà viene visualizzato quando una pagina entra in modalità catalogo e l'interfaccia utente del catalogo diventa visibile.

Vedi anche

• HeaderText
• ASP.NET controlli web part