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 Sub New (
	text As String,
	value As String,
	imageUrl As String,
	navigateUrl As String
)

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="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    If Not IsPostBack Then

      ' Create the menu structure.

      ' Create the root menu item.
      Dim homeMenuItem As New MenuItem("Home", "Root", _
        "Images\Home.jpg", "Home.aspx")

      ' Create the submenu items.
      Dim musicSubMenuItem As New MenuItem("Music", "Category 1", _
        "Images\Music.jpg", "Music.aspx")
      Dim moviesSubMenuItem As 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)

    End If

  End Sub

</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
Available since 2.0
Return to top
Show: