Share via

WebPartZoneBase.EmptyZoneText Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtém ou define uma mensagem exibida quando um controle WebPartZoneBase não contém controles 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

Valor da propriedade

String

Uma cadeia de caracteres que contém a mensagem que aparece em uma zona vazia. Uma cadeia de caracteres específica da cultura padrão é fornecida pelo .NET Framework.

Exemplos

O exemplo de código a seguir demonstra o uso declarativo da EmptyZoneText propriedade em um WebPartZone controle. Para obter o exemplo de código completo, incluindo o arquivo de origem code-behind e a página .aspx que contém a zona neste código, consulte a visão geral da WebPartZoneBase classe.

Observe que a EmptyZoneText propriedade tem um valor atribuído a ela na marcação declarativa. Esse valor será exibido em WebPartZone2, depois de carregar a página em um navegador, alternar a página para o modo de exibição de design e arrastar o controle que exibe a data para WebPartZone2 WebPartZone1. Para obter mais informações sobre como alterar os modos de exibição em uma página Web Parts, consulte Passo a passo: Alterando modos de exibição em uma página de Web Parts.

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

Comentários

A EmptyZoneText propriedade substitui a propriedade base para distinguir entre os casos em que a propriedade não foi definida e aquelas em que ela foi definida como uma cadeia de caracteres vazia ("").

Se a propriedade não tiver sido definida e a zona não contiver controles, quando uma página Web Parts entrar em um modo de exibição em que a zona está visível, uma mensagem de texto específica da cultura padrão será exibida em um controle vazioWebPartZoneBase. Se o valor da EmptyZoneText propriedade tiver sido definido intencionalmente como uma cadeia de caracteres vazia, nenhuma mensagem de texto será exibida em uma zona vazia.

Aplica-se a

Confira também