Menu.MaximumDynamicDisplayLevels 屬性

定義

取得或設定要針對動態功能表呈現的功能表層級數目。Gets or sets the number of menu levels to render for a dynamic menu.

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

屬性值

Int32

要針對動態功能表呈現的功能表層級數目。The number of menu levels to render for a dynamic menu. 預設值為 3。The default is 3.

屬性

例外狀況

MaximumDynamicDisplayLevels 屬性會設定為小於 0 的值。The MaximumDynamicDisplayLevels property is set to a value less than 0.

範例

下列程式碼範例示範如何使用 MaximumDynamicDisplayLevels 屬性,將動態功能表中顯示的功能表層級數目限制為1。The following code example demonstrates how to use the MaximumDynamicDisplayLevels property to limit the number of menu levels to display in a dynamic menu to 1. 只會顯示根功能表層級。Only the root menu level is displayed.


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

備註

您可以藉由將 StaticDisplayLevels 屬性設定為大於1的值,在 [靜態] 功能表中顯示多個功能表層級。You can display multiple menu levels in the static menu by setting the StaticDisplayLevels property to a value greater than 1. 您也可以將此屬性設定為大於0的值,以在動態功能表中顯示其他層級。You can also display additional levels in dynamic menus by setting this property to a value greater than 0. 例如,如果您在 [靜態] 功能表中顯示兩個功能表層級 (藉由將 StaticDisplayLevels 屬性設定為 2) 然後將此屬性設定為3,則動態功能表中會顯示三個額外的功能表層級。For example, if you display two menu levels in the static menu (by setting the StaticDisplayLevels property to 2) and then set this property to 3, three additional menu levels are displayed in dynamic menus. 所有剩餘的較高功能表層級 (是否捨棄任何) 。All remaining higher menu levels (if any) are discarded.

注意

將此屬性設定為0會顯示平面功能表,直到屬性所指定的層級 StaticDisplayLevels ,不含任何動態功能表。Setting this property to 0 displays a flat menu up to the level specified by the StaticDisplayLevels property, without any dynamic menus.

適用於

另請參閱