Sdílet prostřednictvím

CatalogZoneBase.EmptyZoneText Vlastnost

  • Reference

Definice

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

Získá nebo nastaví zprávu, která se zobrazí, když zóna neobsahuje žádné ovládací prvky.

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

Hodnota vlastnosti

String

Řetězec obsahující zprávu, která se zobrazí v prázdné zóně. 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 EmptyZoneText vlastnost deklarativně. Ú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 a druhý nehlásí žádné CatalogPart ovládací prvky, i když přiřadí hodnotu vlastnosti EmptyZoneText .

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

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, že pod první zónou, která obsahuje dva CatalogPart ovládací prvky, se zobrazí druhá zóna a zobrazí obsah EmptyZoneText vlastnosti, protože neobsahuje žádné ovládací prvky.

Poznámky

Řetězcová hodnota EmptyZoneText vlastnosti se zobrazí, když webová stránka přejde do režimu katalogu, pokud CatalogZoneBase zóna neobsahuje žádné CatalogPart ovládací prvky.

Platí pro

Viz také