MenuItemCollection.AddAt(Int32, MenuItem) メソッド

定義

指定した MenuItem オブジェクトを、現在の MenuItemCollection オブジェクトの指定したインデックス位置に挿入します。Inserts the specified MenuItem object in the current MenuItemCollection object at the specified index location.

public:
 void AddAt(int index, System::Web::UI::WebControls::MenuItem ^ child);
public void AddAt (int index, System.Web.UI.WebControls.MenuItem child);
member this.AddAt : int * System.Web.UI.WebControls.MenuItem -> unit
Public Sub AddAt (index As Integer, child As MenuItem)

パラメーター

index
Int32

MenuItem を挿入する位置の、0 から始まるインデックス。The zero-based index location at which to insert the MenuItem.

child
MenuItem

挿入する MenuItemThe MenuItem to insert.

次のコード例では、AddAt メソッドを使用して、指定したインデックス位置にある MenuItemCollection オブジェクトに MenuItem オブジェクトをプログラムで挿入する方法を示します。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#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 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>


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

注釈

AddAt メソッドを使用して、指定した MenuItem オブジェクトをコレクション内の指定したインデックス位置に挿入します。Use the AddAt method to insert the specified MenuItem object in the collection at the specified index.

注意

Null 値を追加し、コレクションに MenuItem オブジェクトを複製することができます。You can add null values and duplicate MenuItem objects to the collection.

別の方法として、Add メソッドを使用して、コレクションの末尾に MenuItem オブジェクトを追加することもできます。As an alternative, you can simply append a MenuItem object to the end of the collection by using the Add method.

適用対象

こちらもご覧ください