ASPxMenuBase.Items Property

Gets a collection that contains menu items of the menu’s root level.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

public MenuItemCollection Items { get; }

VB.NET

Public ReadOnly Property Items As MenuItemCollection

Property Value

Type	Description
MenuItemCollection	A MenuItemCollection that contains the root level menu items of the current menu control.

Remarks

Use the Items property (collection) to access menu items of the current menu control’s root level, if any. To access menu items further down the menu tree, use the MenuItem.Items property of a subsequent menu item. If the Items property is the null reference (Nothing in Visual Basic), the current menu does not have any menu items.

The Items property can be also used to programmatically manage the root menu items of the current menu item. You can add, insert, remove, retrieve, and modify MenuItem objects from the collection. Any updates to the collection will be automatically reflected in the menu control the next time the page is refreshed.

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>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Items property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-implement-the-copy-paste-appointment-operation-via-the-context-menu-t164287/CS/WebApplication1/Default.aspx.cs#L81

newItemCopy.ItemStyle.Font.Bold = true;
e.Menu.Items.Add(newItemCopy);
e.Menu.JSProperties["cpMenuName"] = "AppointmentMenu";

how-to-change-an-appointments-custom-field-values-via-the-appointment-context-menu-like-fo-t164645/CS/WebApplication1/Default.aspx.cs#L94

    }
    e.Menu.Items.Add(newItem);
}

VB.NET

how-to-implement-the-copy-paste-appointment-operation-via-the-context-menu-t164287/VB/WebApplication1/Default.aspx.vb#L84

newItemCopy.ItemStyle.Font.Bold = True
e.Menu.Items.Add(newItemCopy)
e.Menu.JSProperties("cpMenuName") = "AppointmentMenu"

how-to-change-an-appointments-custom-field-values-via-the-appointment-context-menu-like-fo-t164645/VB/WebApplication1/Default.aspx.vb#L96

    Next customFieldValue
    e.Menu.Items.Add(newItem)
End If