Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

MenuItem Constructor (String, String, String, String)

Initializes a new instance of the MenuItem class using the specified menu text, value, image URL, and navigation URL.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
public MenuItem(
	string text,
	string value,
	string imageUrl,
	string navigateUrl
)

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.

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

Text

The value of the text parameter.

Value

The value of the value parameter.

ImageUrl

The value of the imageUrl parameter.

NavigateUrl

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 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");

      // 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 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"
        target="_blank" 
        runat="server"/>

    </form>
  </body>
</html>

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.