MenuItemCollection.AddAt(Int32, MenuItem) Methode

Definition

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

Fügt das angegebene MenuItem Objekt in das aktuelle MenuItemCollection Objekt an der angegebenen Indexposition ein.

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)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der MenuItemIndex eingefügt werden soll.

child
MenuItem

Der einzufügende Text MenuItem .

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie AddAt die Methode zum programmgesteuerten Einfügen eines MenuItem Objekts in ein MenuItemCollection Objekt an einer angegebenen Indexposition verwendet wird.


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

Hinweise

Verwenden Sie die AddAt Methode, um das angegebene MenuItem Objekt in die Auflistung am angegebenen Index einzufügen.

Note

Sie können der Auflistung Nullwerte und doppelte MenuItem Objekte hinzufügen.

Alternativ können Sie ein MenuItem Objekt einfach mithilfe der Add Methode an das Ende der Auflistung anfügen.

Gilt für:

Weitere Informationen