WebPartZoneBase.EmptyZoneText Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает сообщение, которое отображается, когда 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, setPublic Overrides Property EmptyZoneText As 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 Если значение свойства намеренно задано в пустую строку, текстовое сообщение не отображается в пустой зоне.
