MenuItemCollection.AddAt Method (Int32, MenuItem)

 

Inserts the specified MenuItem object in the current MenuItemCollection object at the specified index location.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

Public Sub AddAt (
	index As Integer,
	child As MenuItem
)

Parameters

index
Type: System.Int32

The zero-based index location at which to insert the MenuItem.

child
Type: System.Web.UI.WebControls.MenuItem

The MenuItem to insert.

Use the AddAt method to insert the specified MenuItem object in the collection at the specified index.

System_CAPS_noteNote

You can add null values and duplicate MenuItem objects to the collection.

As an alternative, you can simply append a MenuItem object to the end of the collection by using the Add method.

The following code example demonstrates how to use the AddAt method to programmatically insert a MenuItem object in a MenuItemCollection object at a specified index location.


<%@ 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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    If Not IsPostBack Then

      ' Retrieve the root menu item from the Items
      ' collection of the Menu control.
      Dim homeMenuItem As MenuItem = NavigationMenu.Items(0)

      ' Create the submenu item.
      Dim newSubMenuItem = New MenuItem("New Category")

      ' Insert the submenu item in the ChildItems
      ' collection of the root menu item at index 0.
      homeMenuItem.ChildItems.AddAt(0, newSubMenuItem)

    End If

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection AddAt Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemCollection AddAt Example</h3>

      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        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>

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

.NET Framework
Available since 2.0
Return to top
Show: