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, после загрузки страницы в браузер, переключения страницы в режим отображения макета и перетаскивания элемента управления, отображающего дату, в WebPartZone2 .WebPartZone1 Дополнительные сведения об изменении режимов отображения на странице веб-частей см. в разделе Пошаговое руководство. Изменение режимов отображения на странице веб-частей.

<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 Если для свойства намеренно задана пустая строка, текстовое сообщение не отображается в пустой зоне.

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

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