WebZone.EmptyZoneText Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Получает или задает сообщение, которое появляется, когда в зоне нет элементов управления.

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

Значение свойства

String

Строка, содержащая сообщение, которое отображается в пустой зоне. Строка по умолчанию, зависящая от языка и региональных параметров, предоставляется .NET Framework.

Примеры

В следующем примере кода демонстрируется использование EmptyZoneText свойство. Обратите внимание, что в декларативной разметке есть две зоны, а второй <asp:webpartzone> элемент пуст.

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

В браузере можно переключиться в режим конструктора, чтобы увидеть текст, предоставленный EmptyZoneText для свойства, отображаемого в пустой зоне. Дополнительные сведения о том, как изменить режимы отображения страницы, см. в разделе Пошаговое руководство. Изменение режимов отображения на странице веб-частей.

Комментарии

Текст в свойстве EmptyZoneText отображается, если в зоне нет элементов управления, а зона находится в одном из режимов персонализации, например в режиме редактирования, оформления или каталога.

Примечание

Когда зона переходит в один из режимов персонализации, который позволяет вносить изменения персонализации в содержимое зоны, элемент управления устанавливает WebPartDisplayMode.AllowPageDesign значение true свойства в объекте режима отображения, WebPartManager на который ссылается его WebPartManager.DisplayMode свойство.

Применяется к

См. также раздел