Compartir por

Menu.MaximumDynamicDisplayLevels Propiedad

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el número de niveles de menú que se van a representar para un menú dinámico.

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

Valor de propiedad

Int32

Número de niveles de menú que se van a representar para un menú dinámico. El valor predeterminado es 3.

Atributos
ThemeableAttribute

Excepciones

ArgumentOutOfRangeException

La MaximumDynamicDisplayLevels propiedad se establece en un valor menor que 0.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la MaximumDynamicDisplayLevels propiedad para limitar el número de niveles de menú que se van a mostrar en un menú dinámico a 1. Solo se muestra el nivel de menú raíz.


<%@ 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>

Comentarios

Puede mostrar varios niveles de menú en el menú estático estableciendo la StaticDisplayLevels propiedad en un valor mayor que 1. También puede mostrar niveles adicionales en menús dinámicos estableciendo esta propiedad en un valor mayor que 0. Por ejemplo, si muestra dos niveles de menú en el menú estático (estableciendo la StaticDisplayLevels propiedad en 2) y, a continuación, establece esta propiedad en 3, se muestran tres niveles de menú adicionales en menús dinámicos. Todos los niveles de menú superiores restantes (si los hay) se descartan.

Nota:

Al establecer esta propiedad en 0 se muestra un menú plano hasta el nivel especificado por la StaticDisplayLevels propiedad, sin menús dinámicos.

Se aplica a

Consulte también