MenuItem Constructor (String, String, String, String, String)
Initializes a new instance of the MenuItem class using the specified menu text, value, image URL, navigation URL, and target.
Assembly: System.Web (in System.Web.dll)
public MenuItem( string text, string value, string imageUrl, string navigateUrl, string target )
Parameters
- text
-
Type:
System.String
The text displayed for a menu item in a Menu control.
- value
-
Type:
System.String
The supplemental data associated with the menu item, such as data used for handling postback events.
- imageUrl
-
Type:
System.String
The URL to an image displayed next to the text in a menu item.
- navigateUrl
-
Type:
System.String
The URL to link to when the menu item is clicked.
- target
-
Type:
System.String
The target window or frame in which to display the Web page content linked to a menu item when the menu item is clicked.
Use this constructor to create a new instance of the MenuItem class using the menu text, value, image URL, navigation URL, and target specified by the text, value, imageUrl, navigateUrl, and target parameters, respectively.
The following table shows initial property values for an instance of the MenuItem class.
Property | Initial value |
|---|---|
The value of the text parameter. | |
The value of the value parameter. | |
The value of the imageUrl parameter. | |
The value of the navigateUrl parameter. | |
The value of the target parameter. |
This constructor is commonly used when dynamically populating the Items collection of a Menu control or the ChildItems collection of a MenuItem object.
The following example demonstrates how to use this constructor to create a new instance of the MenuItem class. The MenuItem object is then used to dynamically populate the menu items in 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) { // Create the menu structure. // Create the root menu item. MenuItem homeMenuItem = new MenuItem("Home", "Root", @"Images\Home.jpg", "Home.aspx", "_self"); // Create the submenu items. MenuItem musicSubMenuItem = new MenuItem("Music", "Category 1", @"Images\Music.jpg", "Music.aspx", "_blank"); MenuItem moviesSubMenuItem = new MenuItem("Movies", "Category 2", @"Images\Movies.jpg", "Movies.aspx", "_blank"); // 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>MenuItem Constructor Example</title> </head> <body> <form id="form1" runat="server"> <h3>MenuItem Constructor Example</h3> <asp:menu id="NavigationMenu" orientation="Vertical" runat="server"/> </form> </body> </html>
Available since 2.0