Menu.MaximumDynamicDisplayLevels Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia liczbę poziomów menu do renderowania dla menu dynamicznego.

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

Wartość właściwości

Int32

Liczba poziomów menu do renderowania dla menu dynamicznego. Wartość domyślna to 3.

Atrybuty: ThemeableAttribute

Wyjątki

ArgumentOutOfRangeException

Właściwość jest ustawiona MaximumDynamicDisplayLevels na wartość mniejszą niż 0.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą MaximumDynamicDisplayLevels właściwości ograniczyć liczbę poziomów menu do wyświetlenia w menu dynamicznym do 1. Zostanie wyświetlony tylko poziom menu głównego.


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

Uwagi

W menu statycznym można wyświetlić wiele poziomów menu, ustawiając StaticDisplayLevels właściwość na wartość większą niż 1. Możesz również wyświetlić dodatkowe poziomy w menu dynamicznym, ustawiając tę właściwość na wartość większą niż 0. Jeśli na przykład w menu statycznym są wyświetlane dwa poziomy menu (przez ustawienie StaticDisplayLevels właściwości na 2), a następnie ustawić tę właściwość na 3, w menu dynamicznym są wyświetlane trzy dodatkowe poziomy menu. Wszystkie pozostałe wyższe poziomy menu (jeśli istnieją) zostaną odrzucone.

Uwaga

Ustawienie tej właściwości na wartość 0 powoduje wyświetlenie płaskiego menu na poziomie określonym przez StaticDisplayLevels właściwość bez żadnych menu dynamicznych.

Dotyczy

Zobacz też

StaticDisplayLevels