MenuItemBindingCollection.Item Property (Int32)
Gets the MenuItemBinding object at the specified index from the collection.
Assembly: System.Web (in System.Web.dll)
Parameters
- i
-
Type:
System.Int32
The zero-based index of the MenuItemBinding to retrieve.
Property Value
Type: System.Web.UI.WebControls.MenuItemBindingThe MenuItemBinding at the specified index in the collection.
Use this indexer to access a MenuItemBinding object from the collection at the specified index using array notation. The indexer allows you to access, modify, or replace a MenuItemBinding object in the collection directly.
The following code example demonstrates how to retrieve a MenuItemBinding object from the collection using the indexer. The properties of the MenuItemBinding object are then updated programmatically. 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 indexer to retrieve the MenuItemBinding // object at index 0. MenuItemBinding binding = NavigationMenu.DataBindings[0]; // Instead of binding the Text property of the Home // menu item to a field from a data source, bind it // to static text. binding.TextField = ""; binding.Text = "Custom Menu Text"; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>MenuItemBindingCollection Indexer Example</title> </head> <body> <form id="form1" runat="server"> <h3>MenuItemBindingCollection Indexer 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"/> </DataBindings> </asp:menu> <asp:xmldatasource id="MenuSource" datafile="Map.xml" runat="server"/> </form> </body> </html>
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>
Available since 2.0