MenuItem Constructor (String, String, String, String)
Assembly: System.Web (in system.web.dll)
public MenuItem ( String text, String value, String imageUrl, String navigateUrl )
public function MenuItem ( text : String, value : String, imageUrl : String, navigateUrl : String )
Parameters
- text
The text displayed for a menu item in a Menu control.
- value
The supplemental data associated with the menu item, such as data used for handling postback events.
- imageUrl
The URL to an image displayed next to the text in a menu item.
- navigateUrl
The URL to link to 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, and navigation URL specified by the text, value, imageUrl, and navigateUrl 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. |
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 code 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#" %> <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"); // Create the submenu items. MenuItem musicSubMenuItem = new MenuItem("Music", "Category 1", @"Images\Music.jpg", "Music.aspx"); MenuItem moviesSubMenuItem = new MenuItem("Movies", "Category 2", @"Images\Movies.jpg", "Movies.aspx"); // 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> <body> <form runat="server"> <h3>MenuItem Constructor Example</h3> <asp:menu id="NavigationMenu" orientation="Vertical" target="_blank" runat="server"/> </form> </body> </html>
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
