WebPartZoneBase.EmptyZoneText Egenskap

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Hämtar eller anger ett meddelande som visas när en WebPartZoneBase kontroll inte innehåller några WebPart kontroller.

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

Egenskapsvärde

String

En sträng som innehåller meddelandet som visas i en tom zon. En standardkulturspecifik sträng tillhandahålls av .NET Framework.

Exempel

I följande kodexempel visas deklarativ användning av EmptyZoneText egenskapen på en WebPartZone kontroll. Det fullständiga kodexemplet, inklusive källkodsfilen bakom koden och sidan .aspx som innehåller zonen i den här koden, finns i klassöversikten WebPartZoneBase .

Observera att egenskapen EmptyZoneText har tilldelats ett värde i den deklarativa markeringen. Det här värdet visas i WebPartZone2, när du har läst in sidan i en webbläsare, växla sidan till designvisningsläge och dra kontrollen som visar datumet från WebPartZone2 till WebPartZone1. Mer information om hur du ändrar visningslägen på en webbdelssida finns i Genomgång: Ändra visningslägen på en webbsida.

<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>

Kommentarer

Egenskapen EmptyZoneText åsidosätter basegenskapen för att skilja mellan fall där egenskapen inte har angetts och de där den har angetts till en tom sträng ("").

Om egenskapen inte har angetts och zonen inte innehåller några kontroller visas ett kulturspecifikt textmeddelande i en tom WebPartZoneBase kontroll när en webbdelssida övergår till ett visningsläge där zonen är synlig. Om egenskapsvärdet EmptyZoneText avsiktligt har angetts till en tom sträng visas inget textmeddelande i en tom zon.

Gäller för

Se även