This documentation is archived and is not being maintained.

MenuItemCollection.AddAt Method

Note: This method is new in the .NET Framework version 2.0.

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 void AddAt (
	int index,
	MenuItem child
)
public void AddAt (
	int index, 
	MenuItem child
)
public function AddAt (
	index : int, 
	child : MenuItem
)

Parameters

index

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

child

The MenuItem to insert.

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

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="C#" %>

<script runat="server">
    
  void Page_Load(Object sender, EventArgs e)
  {
    if (!IsPostBack)
    {
      // Retrieve the root menu item from the Items
      // collection of the Menu control.
      MenuItem homeMenuItem = NavigationMenu.Items[0];

      // Create the submenu item.
      MenuItem 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);
    }
  }

</script>

<html>
  <body>
    <form 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>


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: