MenuItemCollection.Remove(MenuItem) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verwijdert u het opgegeven MenuItem object uit het MenuItemCollection object.
public:
void Remove(System::Web::UI::WebControls::MenuItem ^ value);
public void Remove(System.Web.UI.WebControls.MenuItem value);
member this.Remove : System.Web.UI.WebControls.MenuItem -> unit
Public Sub Remove (value As MenuItem)
Parameters
Uitzonderingen
value is null.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de Remove methode gebruikt om programmatisch een MenuItem object uit een MenuItemCollection object te verwijderen.
<%@ 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>
<%@ 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)
' Retrieve the Movie submenu item from the ChildItems
' collection of the root menu item.
Dim movieSubMenuItem As MenuItem = NavigationMenu.FindItem("Home\Movies")
' Remove the Movie submenu item.
If movieSubMenuItem IsNot Nothing Then
homeMenuItem.ChildItems.Remove(movieSubMenuItem)
End If
End If
End Sub
</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>
Opmerkingen
Gebruik de Remove methode om het opgegeven menu-item uit de verzameling te verwijderen. Alle items die volgen op dat menu-item worden vervolgens omhoog verplaatst om de leegte positie in te vullen. De indexen van de verplaatste items worden ook bijgewerkt.
Note
Het MenuItemCollection object kan null-waarden en dubbele MenuItem objecten bevatten.
Als alternatief kunt u een menu-item uit een specifieke index in de verzameling verwijderen met behulp van de RemoveAt methode. U kunt ook alle menu-items uit de verzameling verwijderen met behulp van de Clear methode.