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; }
member this.MaximumDynamicDisplayLevels : int with get, set
Public Property MaximumDynamicDisplayLevels As Integer

プロパティ値

動的メニューに表示するメニュー レベルの数。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. たとえば、静的メニューに2つのメニューレベルを表示した場合 ( StaticDisplayLevelsプロパティを2に設定)、このプロパティを3に設定すると、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.

適用対象

こちらもご覧ください