WebZone.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 una zona no contiene controles.

public:
 virtual property System::String ^ EmptyZoneText { System::String ^ get(); void set(System::String ^ value); };
public virtual string EmptyZoneText { get; set; }
member this.EmptyZoneText : string with get, set
Public Overridable 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 de la EmptyZoneText propiedad . Tenga en cuenta que hay dos zonas en el marcado declarativo y el segundo <asp:webpartzone> elemento está vacío.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

En un explorador, puede cambiar al modo de diseño para ver el texto proporcionado para la EmptyZoneText propiedad mostrada en la zona vacía. Para obtener más información sobre cómo cambiar los modos de visualización de página, vea Tutorial: Cambiar modos de presentación en una página de elementos web.

Comentarios

El texto de la EmptyZoneText propiedad aparece cuando no hay controles en una zona y la zona está en uno de los modos de personalización, como el modo de edición, diseño o catálogo.

Nota:

Cuando una zona entra en uno de los modos de personalización que permitirían realizar cambios de personalización en el contenido de la zona, el WebPartManager control establece el WebPartDisplayMode.AllowPageDesign valor true de propiedad en en el objeto de modo de presentación al que se hace referencia en su WebPartManager.DisplayMode propiedad.

Se aplica a

Consulte también