WebPartZoneBase.EmptyZoneText Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Obtiene o establece un mensaje que aparece cuando un control WebPartZoneBase no contiene controles WebPart.

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

Valor de propiedad

String

Cadena que contiene el mensaje que aparece en una zona vacía. .NET Framework proporciona una cadena de referencia cultural predeterminada.

Ejemplos

En el ejemplo de código siguiente se muestra el uso declarativo de la EmptyZoneText propiedad en un WebPartZone control . Para obtener el ejemplo de código completo, incluido el archivo de código fuente subyacente y la página .aspx que contiene la zona de este código, consulte la información general de la WebPartZoneBase clase.

Observe que la EmptyZoneText propiedad tiene asignado un valor en el marcado declarativo. Este valor aparecerá en WebPartZone2, después de cargar la página en un explorador, cambie la página al modo de presentación de diseño y arrastre el control que muestra la fecha de WebPartZone2 a WebPartZone1. Para obtener más información sobre cómo cambiar los modos de visualización en una página de elementos web, vea Tutorial: Cambiar modos de presentación en una página de elementos web.

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

Comentarios

La EmptyZoneText propiedad invalida la propiedad base para distinguir entre los casos en los que no se ha establecido la propiedad y aquellos en los que se ha establecido en una cadena vacía ("").

Si no se ha establecido la propiedad y la zona no contiene controles, cuando una página de elementos web entra en un modo de presentación en el que la zona está visible, aparece un mensaje de texto predeterminado específico de la referencia cultural en un control vacío WebPartZoneBase . Si el valor de la EmptyZoneText propiedad se ha establecido intencionadamente en una cadena vacía, no aparece ningún mensaje de texto en una zona vacía.

Se aplica a

Consulte también