通过

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 提供。

示例

下面的代码示例演示如何在 控件上WebPartZone以声明方式使用 EmptyZoneText 属性。 有关完整的代码示例，包括代码隐藏源文件和包含此代码中的区域的.aspx页，请参阅 WebPartZoneBase 类概述。

请注意， EmptyZoneText 属性在声明性标记中分配了一个值。 将页面加载到浏览器中后，此值将显示在 中 WebPartZone2，将页面切换到设计显示模式，并将显示日期的控件从 WebPartZone2 拖到 中 WebPartZone1。 有关在 Web 部件页中更改显示模式的详细信息，请参阅 演练：更改 Web 部件页上的显示模式。

<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 重写基属性，以区分尚未设置属性的情况和已将其设置为空字符串 (“”) 的情况。

如果尚未设置 属性，并且区域不包含控件，则当 Web 部件页进入显示模式（该区域可见）时，空 WebPartZoneBase 控件中将显示特定于区域性的默认文本消息。 如果已有意将 EmptyZoneText 属性值设置为空字符串，则空区域中不会显示任何文本消息。

适用于

另请参阅