MenuItemCollection.Add(String) Method

Adds a new item to the collection and specifies the item’s display text.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

public MenuItem Add(
    string text
)

VB.NET

Public Function Add(
    text As String
) As MenuItem

Parameters

Name	Type	Description
text	String	A String value specifying the menu item’s display text. Initializes the menu item’s MenuItem.Text property.

Returns

Type	Description
MenuItem	A MenuItem object representing the newly created menu item.

Remarks

Use the Add method to add a new menu item with the specified text to the MenuItemCollection object.

Example

The code sample below demonstrates how to populate an ASPxMenu control with items manually, in unbound mode. The image below shows the result.

C#

protected void Page_Load(object sender, EventArgs e)
{
     if (!IsPostBack) {
          CreateMenu();
     }
}

//Create Menu initial structure. 
void CreateMenu() {
     string[] Items = { "Home", "News", "Products", "Client Center" };
     foreach (string ItemText in Items) {
          MyMenu.Items.Add(ItemText);
     }
     MyMenu.Items.FindByText("News").Items.Add("Subscriptions");
     MenuItem[] ProductsItems = { 
          new MenuItem("Downloads"), 
          new MenuItem("Support"), 
          new MenuItem("Order") 
     };
     MyMenu.Items.FindByText("Products").Items.Add(ProductsItems);
}

//Add a new item
protected void btnAddItem_Click(object sender, EventArgs e) {
     if ((MyMenu.SelectedItem != null) && (tbItemName.Text != "")) {
          MyMenu.SelectedItem.Items.Add(tbItemName.Text);
     }
} 

VB.NET

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
     If (Not IsPostBack) Then
          CreateMenu()
     End If
End Sub

'Create Menu initial structure. 
Private Sub CreateMenu()
     Dim Items() As String = { "Home", "News", "Products", "Client Center" }
     For Each ItemText As String In Items
          MyMenu.Items.Add(ItemText)
     Next ItemText
     MyMenu.Items.FindByText("News").Items.Add("Subscriptions")
     Dim ProductsItems() As MenuItem = { New MenuItem("Downloads"), New MenuItem("Support"), New MenuItem("Order") }
     MyMenu.Items.FindByText("Products").Items.Add(ProductsItems)
End Sub

'Add a new item
Protected Sub btnAddItem_Click(ByVal sender As Object, ByVal e As EventArgs)
     If (MyMenu.SelectedItem IsNot Nothing) AndAlso (tbItemName.Text <> "") Then
          MyMenu.SelectedItem.Items.Add(tbItemName.Text)
     End If
End Sub

ASPX

<dx:ASPxMenu ID="MyMenu" runat="server" AllowSelectItem="True">
</dx:ASPxMenu>
<br />
<dx:ASPxTextBox ID="tbItemName" runat="server" Width="170px">
</dx:ASPxTextBox>
<br />
<dx:ASPxButton ID="btnAddItem" runat="server" onclick="btnAddItem_Click" Text="Add Subitem">
</dx:ASPxButton>