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 vers le mode Création pour voir le texte fourni pour la EmptyZoneText propriété affiché 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, création ou catalogue.

Notes

Lorsqu’une zone entre dans l’un des modes de personnalisation qui permet 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 de mode d’affichage référencé dans sa WebPartManager.DisplayMode propriété.

S’applique à

Voir aussi