Menu.MaximumDynamicDisplayLevels Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le nombre de niveaux de menu à rendre pour un menu dynamique.

public:
 property int MaximumDynamicDisplayLevels { int get(); void set(int value); };

[System.Web.UI.Themeable(true)]
public int MaximumDynamicDisplayLevels { get; set; }

[<System.Web.UI.Themeable(true)>]
member this.MaximumDynamicDisplayLevels : int with get, set

Public Property MaximumDynamicDisplayLevels As Integer

Valeur de propriété

Int32

Nombre de niveaux de menu à rendre pour un menu dynamique. La valeur par défaut est 3.

Attributs: ThemeableAttribute

Exceptions

ArgumentOutOfRangeException

La valeur affectée à la propriété MaximumDynamicDisplayLevels est inférieure à 0.

Exemples

L’exemple de code suivant montre comment utiliser la MaximumDynamicDisplayLevels propriété pour limiter le nombre de niveaux de menu à afficher dans un menu dynamique à 1. Seul le niveau de menu racine s’affiche.


<%@ Page Language="C#" %>

<!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 runat="server">
    <title>Menu MaximumDynamicDisplayLevels Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu MaximumDynamicDisplayLevels Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        maximumdynamicdisplaylevels="1" 
        orientation="Vertical"   
        runat="server">
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>


<%@ Page Language="VB" %>

<!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 runat="server">
    <title>Menu MaximumDynamicDisplayLevels Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu MaximumDynamicDisplayLevels Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        maximumdynamicdisplaylevels="1" 
        orientation="Vertical"   
        runat="server">
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>

Remarques

Vous pouvez afficher plusieurs niveaux de menu dans le menu statique en définissant la StaticDisplayLevels propriété sur une valeur supérieure à 1. Vous pouvez également afficher des niveaux supplémentaires dans les menus dynamiques en définissant cette propriété sur une valeur supérieure à 0. Par exemple, si vous affichez deux niveaux de menu dans le menu statique (en définissant la propriété sur StaticDisplayLevels 2), puis définissez cette propriété sur 3, trois niveaux de menu supplémentaires sont affichés dans les menus dynamiques. Tous les niveaux de menu supérieurs restants (le cas échéant) sont ignorés.

Notes

La définition de cette propriété sur 0 affiche un menu plat jusqu’au niveau spécifié par la StaticDisplayLevels propriété, sans menus dynamiques.

S’applique à

Voir aussi

StaticDisplayLevels