WebPartZoneBase.EmptyZoneText Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá nebo nastaví zprávu, která se zobrazí, když WebPartZoneBase ovládací prvek neobsahuje žádné WebPart 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 deklarativní použití EmptyZoneText vlastnosti WebPartZone ovládacího prvku. Úplný příklad kódu, včetně zdrojového souboru kódu na pozadí a stránky .aspx, která obsahuje zónu v tomto kódu, najdete v přehledu WebPartZoneBase třídy.

Všimněte si, že EmptyZoneText vlastnost má přiřazenou hodnotu v deklarativním kódu. Tato hodnota se zobrazí v WebPartZone2, po načtení stránky do prohlížeče přepněte stránku do režimu zobrazení návrhu a přetáhněte ovládací prvek, který zobrazuje datum z WebPartZone2 do WebPartZone1. Další informace o změně režimů zobrazení na stránce webových částí najdete v tématu Návod: Změna režimů zobrazení na stránce webových částí.

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

Poznámky

Vlastnost EmptyZoneText přepíše základní vlastnost a rozlišuje mezi případy, kdy vlastnost nebyla nastavena, a případy, kdy byla nastavena na prázdný řetězec ("").

Pokud vlastnost nebyla nastavena a zóna neobsahuje žádné ovládací prvky, když stránka webových částí přejde do režimu zobrazení, kde je zóna viditelná, zobrazí se výchozí textová zpráva specifická pro jazykovou verzi v prázdném WebPartZoneBase ovládacím prvku. EmptyZoneText Pokud byla hodnota vlastnosti záměrně nastavena na prázdný řetězec, nezobrazí se v prázdné zóně žádná textová zpráva.

Viz také

• EmptyZoneText
• ASP.NET ovládací prvky webových částí