WebPartZoneBase.EmptyZoneText Свойство

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

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

public:
 virtual property System::String ^ EmptyZoneText { System::String ^ get(); void set(System::String ^ value); };

public override string EmptyZoneText { get; set; }

member this.EmptyZoneText : string with get, set

Public Overrides Property EmptyZoneText As String

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

String

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

Примеры

В следующем примере кода демонстрируется декларативное EmptyZoneText использование свойства в элементе WebPartZone управления . Полный пример кода, включая исходный файл программной части и страницу .aspx, содержащую зону в этом коде, см. в обзоре WebPartZoneBase класса .

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

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

Комментарии

Свойство EmptyZoneText переопределяет базовое свойство, чтобы различать случаи, в которых свойство не задано, и случаи, в которых для него была задана пустая строка ("").

Если свойство не задано и зона не содержит элементов управления, при переходе страницы веб-частей в режим отображения, в котором зона видна, в пустом WebPartZoneBase элементе управления отображается текстовое сообщение, соответствующее языку и региональным параметрам. EmptyZoneText Если для значения свойства намеренно задана пустая строка, текстовое сообщение не отображается в пустой зоне.

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

• EmptyZoneText
• элементы управления веб-частей ASP.NET