WebPartZoneBase.EmptyZoneText Propriété

  • Référence

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, y compris le fichier source code-behind et la page .aspx qui contient la zone de 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 apparaît dans WebPartZone2, après avoir chargé la page dans un navigateur, basculer la page en mode d’affichage création et faire glisser le contrôle qui affiche la date à WebPartZone1partir de WebPartZone2 . Pour plus d’informations sur la modification des modes d’affichage dans une page composants WebPart, consultez procédure pas à pas : modification des modes d’affichage sur une page 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 celles 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 composants WebPart entre dans un mode d’affichage où la zone est visible, un message texte propre à la culture par défaut apparaît dans un contrôle videWebPartZoneBase. Si la valeur de propriété EmptyZoneText a intentionnellement été définie sur une chaîne vide, aucun message texte n’apparaît dans une zone vide.

S’applique à

Voir aussi