MenuItemBindingCollection.RemoveAt(Int32) Methode

Definition

Entfernt das MenuItemBinding-Objekt an der angegebenen Indexposition aus der Auflistung.Removes the MenuItemBinding object at the specified index location from the collection.

public:
 void RemoveAt(int index);
public void RemoveAt (int index);
member this.RemoveAt : int -> unit
Public Sub RemoveAt (index As Integer)

Parameter

index
Int32

Die nullbasierte Position des Index der zu entfernenden Menüelementbindung.The zero-based index location of the menu item binding to remove.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die RemoveAt -Methode verwendet wird MenuItemBinding , um ein-Objekt an einem bestimmten Index aus der Auflistung zu entfernen.The following code example demonstrates how to use the RemoveAt method to remove a MenuItemBinding object from the collection at a specific index. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispiel Daten in eine Datei mit dem Namen "map. xml" kopieren.For this example to work correctly, you must copy the sample XML data below to a file named Map.xml.


<%@ 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)
    {
      // Use the RemoveAt method to remove the  
      // MenuItemBinding object at index 3 from
      // the Bindings collection.
      NavigationMenu.DataBindings.RemoveAt(3);
    }
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection RemoveAt Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection RemoveAt Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
          <asp:menuitembinding datamember="MapHomeNode" 
            depth="0"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="ExtraMapNode" 
            depth="3"
            textfield="title" 
            navigateurlfield="url"/>
        </databindings>
                
      </asp:menu>
      
      <asp:xmldatasource id="MenuSource"
        datafile="Map.xml"
        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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    If Not IsPostBack Then
    
      ' Use the RemoveAt method to remove the  
      ' MenuItemBinding object at index 3 from
      ' the Bindings collection.
      NavigationMenu.DataBindings.RemoveAt(3)
    
    End If
    
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection RemoveAt Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection RemoveAt Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
          <asp:menuitembinding datamember="MapHomeNode" 
            depth="0"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="ExtraMapNode" 
            depth="3"
            textfield="title" 
            navigateurlfield="url"/>
        </databindings>
                
      </asp:menu>
      
      <asp:xmldatasource id="MenuSource"
        datafile="Map.xml"
        runat="server"/>        

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

Im folgenden finden Sie Beispiele für Site Übersichts Daten für das vorherige Beispiel.The following is sample site map data for the previous example.

<MapHomeNode url="~\Home.aspx"

title="Home"

description="Home">

<MapNode url="~\Music.aspx"

title="Music"

description="Music">

<MapNode url="~\Classical.aspx"

title="Classical"

description="Classical"/>

<MapNode url="~\Rock.aspx"

title="Rock"

description="Rock"/>

<MapNode url="~\Jazz.aspx"

title="Jazz"

description="Jazz"/>

</MapNode>

<MapNode url="~\Movies.aspx"

title="Movies"

description="Movies">

<MapNode url="~\Action.aspx"

title="Action"

description="Action"/>

<MapNode url="~\Drama.aspx"

title="Drama"

description="Drama"/>

<MapNode url="~\Musical.aspx"

title="Musical"

description="Musical"/>

</MapNode>

</MapHomeNode>

Hinweise

Verwenden Sie RemoveAt die-Methode, MenuItemBinding um das Objekt an der angegebenen Indexposition aus der Auflistung zu entfernen.Use the RemoveAt method to remove the MenuItemBinding object at the specified index location from the collection. Alle Elemente, die diesem Menü Element folgen, werden dann nach oben verschoben, um die freie Position auszufüllen.All items that follow that menu item are then moved up to fill in the vacant position. Die Indizes der verschoanderen Elemente werden ebenfalls aktualisiert.The indexes of the moved items are also updated.

Hinweis

Die Auflistung kann NULL-Werte sowie doppelte MenuItemBinding Objekte enthalten.The collection can contain null values, as well as duplicate MenuItemBinding objects.

Als Alternative können Sie ein bestimmtes MenuItemBinding Objekt mithilfe der Remove -Methode entfernen.As an alternative, you can remove a specific MenuItemBinding object by using the Remove method. Sie können auch alle Menü Elemente aus der Auflistung entfernen, indem Sie Clear die-Methode verwenden.You can also remove all menu items from the collection by using the Clear method.

Gilt für:

Siehe auch