Menu.MaximumDynamicDisplayLevels プロパティ

定義

動的メニューに表示するメニュー レベルの数を取得または設定します。

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

動的メニューに表示するメニュー レベルの数。 既定値は 3 です。

属性

例外

MaximumDynamicDisplayLevels プロパティは、0 未満の値が設定されています。

次のコード例では、プロパティを使用 MaximumDynamicDisplayLevels して、動的メニューに表示するメニュー レベルの数を 1 に制限する方法を示します。 ルート メニュー レベルのみが表示されます。


<%@ 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 より大きい値に設定します。 このプロパティを 0 より大きい値に設定することで、動的メニューに追加のレベルを表示することもできます。 たとえば、静的メニューに (プロパティを 2 に設定 StaticDisplayLevels して) 2 つのメニュー レベルを表示し、このプロパティを 3 に設定すると、3 つの追加メニュー レベルが動的メニューに表示されます。 残りの上位メニュー レベル (存在する場合) はすべて破棄されます。

注意

このプロパティを 0 に設定すると、プロパティで指定されたレベルまでのフラット メニューが StaticDisplayLevels 表示され、動的メニューは表示されなくなります。

適用対象

こちらもご覧ください