Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]ASP.NET WebForms Controls
 [Collapse]ASP.NET MVC Extensions
  [Expand]Product Information
  [Expand]Getting Started
  [Expand]Common Concepts
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]HTML Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Collapse]Navigation and Layout Extensions
   [Expand]FormLayout
   [Expand]Menu
   [Collapse]NavBar
     Overview - NavBar
    [Collapse]Concepts
     [Collapse]Binding to Data
       Binding to Data Overview
       Data Binding Using Mapping Properties
       Automatic Data Binding
       Unbound Mode
      Item Link Mode
      Item Bullet Style
      Templates
    [Expand]Visual Elements
   [Expand]Ribbon
   [Expand]PageControl
   [Expand]TabControl
   [Expand]PopupMenu
   [Expand]Splitter
   [Expand]TreeView
   [Expand]Panel
  [Expand]File Management
  [Expand]Multi-Use Site Extensions
  [Expand]Charts
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Tree List
  [Expand]Data Editor Extensions
  [Expand]Report Extensions
  [Expand]SpellChecker
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Data Binding Using Mapping Properties

When the NavBar binds to an arbitrary data source, MVCxNavBarGroup and MVCxNavBarItem objects are created automatically for every recognized first and second level data item respectively. Individual group and item characteristics (such as text, name, image path, navigation location, and tooltip text) are obtained from the data fields (item attributes) of corresponding data items. NavBar exposes its specific data-related properties, allowing you to specify which data source fields the group/item information should be retrieved from. The tables below list these properties and the corresponding properties of MVCxNavBarGroup and MVCxNavBarItem objects.

Groups data-related properties

NavBar data-related properties

Corresponding group object properties

NavBarGroupDataFields.HeaderImageUrlField (via MVCxNavBar.GroupDataFields.HeaderImageUrlField) ImagePropertiesBase.Url (via MVCxNavBarGroup.HeaderImage.Url)
NavBarGroupDataFields.NameField (via MVCxNavBar.GroupDataFields.NameField) NavBarGroup.Name (via MVCxNavBarGroup.Name)
NavBarGroupDataFields.NavigateUrlField (via MVCxNavBar.GroupDataFields.NavigateUrlField) NavBarGroup.NavigateUrl (via MVCxNavBarGroup.NavigateUrl)
NavBarGroupDataFields.TextField (via MVCxNavBar.GroupDataFields.TextField) NavBarGroup.Text (via MVCxNavBarGroup.Text)
NavBarGroupDataFields.ToolTipField (via MVCxNavBar.GroupDataFields.ToolTipField) NavBarGroup.ToolTip (via MVCxNavBarGroup.ToolTip)

Items data-related properties

NavBar data-related properties

Corresponding item object properties

NavBarItemDataFields.ImageUrlField (via MVCxNavBar.ItemDataFields.ImageUrlField) ImagePropertiesBase.Url (via MVCxNavBarItem.Image.Url)
NavBarItemDataFields.NameField (via MVCxNavBar.ItemDataFields.NameField) NavBarItem.Name (via MVCxNavBarItem.Name)
NavBarItemDataFields.NavigateUrlField (via MVCxNavBar.ItemDataFields.NavigateUrlField) NavBarItem.NavigateUrl (via MVCxNavBarItem.NavigateUrl)
NavBarItemDataFields.TextField (via MVCxNavBar.ItemDataFields.TextField) NavBarItem.Text (via MVCxNavBarItem.Text)
NavBarItemDataFields.ToolTipField (via MVCxNavBar.ItemDataFields.ToolTipField) NavBarItem.ToolTip (via MVCxNavBarItem.ToolTip)

The picture below demonstrates the data retrieval path during the binding to an XML file.

How would you rate this topic?​​​​​​​