MenuItem.Parent Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the parent menu item of the current menu item.

public:
 property System::Web::UI::WebControls::MenuItem ^ Parent { System::Web::UI::WebControls::MenuItem ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.MenuItem Parent { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Parent : System.Web.UI.WebControls.MenuItem

Public ReadOnly Property Parent As MenuItem

Property Value

MenuItem

A MenuItem that represents the parent menu item of the current menu item.

Attributes: BrowsableAttribute

Examples

The following example demonstrates how to use the Parent property to access the parent menu item of a child menu item.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void MenuItemClick_NavigationMenu(Object sender, MenuEventArgs e)
  {
    // Use the Parent property to access the 
    // parent menu item of the menu item clicked
    // by the user.
    MenuItem parentItem = e.Item.Parent;

    // Display the parent menu item.
    if (parentItem != null)
    {
      Message.Text = "You are in the " + parentItem.Text + 
        " category.";
    }
    else
    {
      Message.Text = "The selected menu item is a root menu item.";
    }
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Parent Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Parent Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        onmenuitemclick="MenuItemClick_NavigationMenu"
        runat="server">
      
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>
      
      <hr/>

      <asp:label id="Message" 
        runat="server"/>

    </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">
<script runat="server">

  Sub MenuItemClick_NavigationMenu(ByVal sender As Object, ByVal e As MenuEventArgs)
  
    ' Use the Parent property to access the 
    ' parent menu item of the menu item clicked
    ' by the user.
    Dim parentItem As MenuItem = e.Item.Parent

    ' Display the parent menu item.
    If parentItem IsNot Nothing Then

      Message.Text = "You are in the " & parentItem.Text & _
        " category."
    
    Else
    
      Message.Text = "The selected menu item is a root menu item."
      
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Parent Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Parent Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        onmenuitemclick="MenuItemClick_NavigationMenu"
        runat="server">
      
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>
      
      <hr/>

      <asp:label id="Message" 
        runat="server"/>

    </form>
  </body>
</html>

Remarks

Use the Parent property to determine the parent menu item or to access its properties.

Note

A root menu item does not have a parent menu item.

To access the submenu items of the current menu item, use the ChildItems property.

Applies to

Share via