Menu.MaximumDynamicDisplayLevels Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die Anzahl der Menüebenen ab, die für ein dynamisches Menü gerendert werden sollen, oder legt diese fest.

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

Eigenschaftswert

Int32

Die Anzahl der Menüebenen, die für ein dynamisches Menü gerendert werden sollen. Der Standardwert ist 3.

Attribute
ThemeableAttribute

Ausnahmen

ArgumentOutOfRangeException

Die MaximumDynamicDisplayLevels-Eigenschaft wird auf einen Wert kleiner als 0 festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die MaximumDynamicDisplayLevels Eigenschaft verwenden, um die Anzahl der Menüebenen einzuschränken, die in einem dynamischen Menü auf 1 angezeigt werden sollen. Nur die Stammmenüebene wird angezeigt.


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

Hinweise

Sie können mehrere Menüebenen im statischen Menü anzeigen, indem Sie die Eigenschaft auf einen Wert festlegen, der StaticDisplayLevels größer als 1 ist. Sie können auch zusätzliche Ebenen in dynamischen Menüs anzeigen, indem Sie diese Eigenschaft auf einen Wert festlegen, der größer als 0 ist. Wenn Sie beispielsweise zwei Menüebenen im statischen Menü anzeigen (indem Sie die StaticDisplayLevels Eigenschaft auf 2 festlegen) und dann diese Eigenschaft auf 3 festlegen, werden drei zusätzliche Menüebenen in dynamischen Menüs angezeigt. Alle verbleibenden höheren Menüebenen (sofern vorhanden) werden verworfen.

Hinweis

Wenn Sie diese Eigenschaft auf 0 festlegen, wird ein flaches Menü bis zur von der StaticDisplayLevels Eigenschaft angegebenen Ebene ohne dynamische Menüs angezeigt.

Gilt für

Siehe auch