WebZone.EmptyZoneText Proprietà

  • Riferimento

Definizione

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

Ottiene o imposta un messaggio che viene visualizzato quando un'area 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 un'area vuota. Una stringa specifica delle impostazioni cultura predefinita 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 delle pagine, 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.

Nota

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 valore true della WebPartDisplayMode.AllowPageDesign proprietà su sull'oggetto modalità di visualizzazione a cui fa riferimento nella relativa WebPartManager.DisplayMode proprietà.

Si applica a

Vedi anche