Condividi tramite

WebZone.EmptyZoneText Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene o imposta un messaggio visualizzato quando una zona non contiene controlli.

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

Valore della proprietà

String

Stringa contenente il messaggio visualizzato in una zona vuota. Una stringa predefinita specifica delle impostazioni cultura viene fornita da .NET Framework.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della EmptyZoneText proprietà . Si noti che nel markup dichiarativo sono presenti due zone e il secondo <asp:webpartzone> elemento è vuoto.

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

In un browser è possibile passare alla modalità progettazione per visualizzare il testo fornito per la EmptyZoneText proprietà visualizzata nella zona vuota. Per informazioni dettagliate su come modificare le modalità di visualizzazione della pagina, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina web part.

Commenti

Il testo nella EmptyZoneText proprietà viene visualizzato quando non sono presenti controlli in una zona e la zona si trova in una delle modalità di personalizzazione, ad esempio modifica, progettazione o modalità catalogo.

Annotazioni

Quando una zona entra in una delle modalità di personalizzazione che consentono di apportare modifiche alla personalizzazione al contenuto della zona, il WebPartManager controllo imposta il WebPartDisplayMode.AllowPageDesign valore della proprietà su true sull'oggetto in modalità di visualizzazione a cui fa riferimento nella relativa WebPartManager.DisplayMode proprietà.

Si applica a

Vedi anche