WebPartZoneBase.EmptyZoneText Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Recebe ou define uma mensagem que aparece quando um WebPartZoneBase controlo não contém controlos 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 de Propriedade

String

Uma cadeia contendo a mensagem que aparece numa zona vazia. Uma cadeia padrão específica de cultura é fornecida pelo .NET Framework.

Exemplos

O seguinte exemplo de código demonstra o uso declarativo da EmptyZoneText propriedade num WebPartZone controlo. Para o exemplo completo do código, incluindo o ficheiro-fonte code-behind e a página .aspx que contém a zona neste código, veja a visão geral da WebPartZoneBase classe.

Note que a EmptyZoneText propriedade tem um valor atribuído na marcação declarativa. Este valor aparecerá em WebPartZone2, depois de carregar a página num navegador, mudar a página para o modo de exibição de design e arrastar o controlo que mostra a data de WebPartZone2 para WebPartZone1. Para mais informações sobre a alteração dos modos de visualização numa página de Web Parts, consulte Guia: Alterar os Modos de Visualização numa 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>

Observações

A EmptyZoneText propriedade sobrepõe-se à propriedade base para distinguir entre casos em que a propriedade não foi definida e aqueles em que foi definida para uma cadeia vazia ("").

Se a propriedade não tiver sido definida e a zona não contiver controlos, quando uma página de Web Parts entra num modo de visualização onde a zona é visível, aparece uma mensagem de texto padrão específica de cultura num controlo vazio WebPartZoneBase . Se o EmptyZoneText valor da propriedade tiver sido intencionalmente definido para uma cadeia vazia, então não aparece nenhuma mensagem de texto numa zona vazia.

Aplica-se a

Ver também