(0) exportieren Drucken
Alle erweitern

MenuItemCollection.Remove-Methode

Entfernt das angegebene MenuItem-Objekt aus dem MenuItemCollection-Objekt.

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

public void Remove (
	MenuItem value
)
public void Remove (
	MenuItem value
)
public function Remove (
	value : MenuItem
)
Nicht zutreffend.

Parameter

value

Das zu entfernende MenuItem-Objekt.

AusnahmetypBedingung

ArgumentNullException

value ist NULL-Verweis (Nothing in Visual Basic).

Entfernen Sie mithilfe der Remove-Methode das angegebene Menüelement aus der Auflistung. Alle diesem Menüelement folgenden Elemente werden dann nach oben verschoben, um die leere Position auszufüllen. Der Index der verschobenen Elemente wird ebenfalls aktualisiert.

HinweisHinweis:

Das MenuItemCollection-Objekt kann NULL-Werte sowie doppelt vorkommende MenuItem-Objekte enthalten.

Sie können ein Menüelement auch mithilfe der RemoveAt-Methode aus einem angegebenen Index in der Auflistung entfernen. Außerdem können Sie mithilfe der Clear-Methode alle Menüelemente aus der Auflistung entfernen.

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der Remove-Methode ein MenuItem-Objekt aus einem MenuItemCollection-Objekt programmgesteuert entfernt 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];

      // Retrieve the Movie submenu item from the ChildItems
      // collection of the root menu item.
      MenuItem movieSubMenuItem = NavigationMenu.FindItem(@"Home\Movies");

      // Remove the Movie submenu item.
      if (movieSubMenuItem != null)
      {
        homeMenuItem.ChildItems.Remove(movieSubMenuItem);
      }
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection Remove Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection Remove 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 Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework

Unterstützt in: 3.0, 2.0
Anzeigen:
© 2014 Microsoft