MenuItemCollection.Clear Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Removes all items from the current MenuItemCollection object.
public:
void Clear();
public void Clear ();
member this.Clear : unit -> unit
Public Sub Clear ()
Examples
The following code example demonstrates how to use the Clear method to remove all items from the Items collection of a Menu control.
<%@ 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 Clear method to remove all
// menu items from the Items collection
// of the Menu control.
NavigationMenu.Items.Clear();
// Create the menu structure.
// Create the root menu item.
MenuItem homeMenuItem = new MenuItem("Home");
// Create the submenu items.
MenuItem musicSubMenuItem = new MenuItem("Music");
MenuItem moviesSubMenuItem = new MenuItem("Movies");
// Add the submenu items to the ChildItems
// collection of the root menu item.
homeMenuItem.ChildItems.Add(musicSubMenuItem);
homeMenuItem.ChildItems.Add(moviesSubMenuItem);
// Add the root menu item to the Items collection
// of the Menu control.
NavigationMenu.Items.Add(homeMenuItem);
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemCollection Clear Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemCollection Clear Example</h3>
<asp:menu id="NavigationMenu"
orientation="Vertical"
target="_blank"
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 Clear method to remove all
' menu items from the Items collection
' of the Menu control.
NavigationMenu.Items.Clear()
' Create the menu structure.
' Create the root menu item.
Dim homeMenuItem As New MenuItem("Home")
' Create the submenu items.
Dim musicSubMenuItem As New MenuItem("Music")
Dim moviesSubMenuItem As New MenuItem("Movies")
' Add the submenu items to the ChildItems
' collection of the root menu item.
homeMenuItem.ChildItems.Add(musicSubMenuItem)
homeMenuItem.ChildItems.Add(moviesSubMenuItem)
' Add the root menu item to the Items collection
' of the Menu control.
NavigationMenu.Items.Add(homeMenuItem)
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemCollection Clear Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemCollection Clear Example</h3>
<asp:menu id="NavigationMenu"
orientation="Vertical"
target="_blank"
runat="server"/>
</form>
</body>
</html>
Remarks
Use the Clear method to remove every MenuItem object from the current MenuItemCollection object.
Note
To remove an individual node from the collection, consider using the Remove or the RemoveAt method.