WebZone.EmptyZoneText Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 EmptyZoneText della proprietà. Si noti che sono presenti due zone nel markup dichiarativo 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à di 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.

Nota

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

Si applica a

Vedi anche

ASP.NET controlli web part