Export (0) Print
Expand All

MenuItem Constructor (String, String, String, String, String)

Note: This constructor is new in the .NET Framework version 2.0.

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public MenuItem (
	string text,
	string value,
	string imageUrl,
	string navigateUrl,
	string target
)
public MenuItem (
	String text, 
	String value, 
	String imageUrl, 
	String navigateUrl, 
	String target
)
public function MenuItem (
	text : String, 
	value : String, 
	imageUrl : String, 
	navigateUrl : String, 
	target : 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.

target

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

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.

Target

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 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", "_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>
  <body>
    <form runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        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.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft