Partager via

WebZone.EmptyZoneText Propriété

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtient ou définit un message qui s’affiche lorsqu’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 spécifique à la culture par défaut 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 afficher 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’existe aucun contrôle dans une zone et que la zone se trouve dans l’un des modes de personnalisation, tels que la modification, la conception ou le mode catalogue.

Note

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

S’applique à

Voir aussi