WebPartZoneBase.EmptyZoneText Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient ou définit un message qui apparaît lorsqu'un contrôle WebPartZoneBase ne contient aucun contrôle 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

Valeur de propriété

String

Chaîne contenant le message qui s’affiche dans une zone vide. Une chaîne par défaut spécifique à la culture est fournie par le .NET Framework.

Exemples

L’exemple de code suivant illustre l’utilisation déclarative de la EmptyZoneText propriété sur un WebPartZone contrôle. Pour obtenir l’exemple de code complet, notamment le fichier source code-behind et la page .aspx qui contient la zone dans ce code, consultez la vue d’ensemble de la WebPartZoneBase classe.

Notez que la EmptyZoneText propriété a une valeur qui lui est affectée dans le balisage déclaratif. Cette valeur s’affiche dans WebPartZone2, une fois que vous avez chargé la page dans un navigateur, basculez la page en mode d’affichage création, puis faites glisser le contrôle qui affiche la date de WebPartZone2 dans WebPartZone1. Pour plus d’informations sur la modification des modes d’affichage dans une page de composants WebPart, consultez Procédure pas à pas : modification des modes d’affichage sur une page de composants WebPart.

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

Remarques

La EmptyZoneText propriété remplace la propriété de base pour faire la distinction entre les cas où la propriété n’a pas été définie et ceux où elle a été définie sur une chaîne vide («  »).

Si la propriété n’a pas été définie et que la zone ne contient aucun contrôle, lorsqu’une page de composants WebPart passe en mode d’affichage où la zone est visible, un message texte spécifique à la culture par défaut s’affiche dans un contrôle vide WebPartZoneBase . Si la valeur de la EmptyZoneText propriété a été définie intentionnellement sur une chaîne vide, aucun message texte n’apparaît dans une zone vide.

Voir aussi

• EmptyZoneText
• contrôles webPart ASP.NET