WebZone.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 s’affiche quand une zone ne contient aucun contrôle.

public:
 virtual property System::String ^ EmptyZoneText { System::String ^ get(); void set(System::String ^ value); };
public virtual string EmptyZoneText { get; set; }
member this.EmptyZoneText : string with get, set
Public Overridable 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 de la EmptyZoneText propriété . Notez qu’il existe deux zones dans le balisage déclaratif et que le deuxième <asp:webpartzone> élément est vide.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

Dans un navigateur, vous pouvez basculer en mode création pour voir le texte fourni pour la EmptyZoneText propriété affichée dans la zone vide. Pour plus d’informations sur la modification des modes d’affichage de page, consultez Procédure pas à pas : modification des modes d’affichage sur une page de composants WebPart.

Remarques

Le texte de la EmptyZoneText propriété s’affiche lorsqu’il n’y a aucun contrôle dans une zone et que la zone est dans l’un des modes de personnalisation, comme le mode édition, conception ou catalogue.

Notes

Lorsqu’une zone entre dans l’un des modes de personnalisation permettant d’apporter des modifications de personnalisation au contenu de la zone, le WebPartManager contrôle définit la valeur true de la WebPartDisplayMode.AllowPageDesign propriété sur sur l’objet en mode d’affichage référencé dans sa WebPartManager.DisplayMode propriété.

S’applique à

Voir aussi