Table of Contents
  • Getting Started
  • EO.Pdf
  • EO.Web
  • EO.WebBrowser
  • EO.Wpf
  • Common Topics
  • Reference
    • .NET API Reference
      • EO.Base
      • EO.Base.UI
      • EO.Extensions
      • EO.Pdf
      • EO.Pdf.Acm
      • EO.Pdf.Contents
      • EO.Pdf.Drawing
      • EO.Pdf.Mvc
      • EO.Web
        • EO.Web
        • Classes
          • AJAXPostedFile Class
          • AJAXPostedFileList Class
          • AJAXUploader Class
          • AJAXUploaderProgressDialog Class
          • ASPXToPDF Class
          • BaseMenuItem Class
          • BaseMenuItemGroup Class
          • BaseNavigator Class
          • BorderImages Class
          • ButtonColumn Class
          • Calendar Class
          • CalendarDay Class
          • Callback Class
          • CallbackEventArgs Class
          • CallbackPanel Class
          • CallbackTrigger Class
          • CallbackTriggerCollection Class
          • Captcha Class
          • CheckBoxColumn Class
          • ClientTemplate Class
          • ColorPicker Class
          • ComboBox Class
          • Consts Class
          • ContextMenu Class
          • Control Class
          • ControlFrame Class
          • CustomColumn Class
          • CustomItem Class
          • DataBinding Class
          • DataBindingCollection Class
          • DataBoundControl Class
          • DateCollection Class
          • DatePicker Class
          • DateTimeColumn Class
          • DayRenderEventArgs Class
          • DefaultClientTemplateAttribute Class
          • DeleteCommandColumn Class
          • DesignOptions Class
          • Dialog Class
          • Downloader Class
          • DownloadEventArgs Class
          • DynamicDownloadContent Class
          • EditableLabel Class
          • EditCommandColumn Class
          • Editor Class
          • EditorDialogContent Class
          • EditorDialogContentCollection Class
          • EditorDialogTemplate Class
          • EditorDialogTemplateCollection Class
          • EditorStyle Class
          • EditorStyleCollection Class
          • EditorTabButtonStyles Class
          • Effect Class
          • ElementPaddings Class
          • ElementStyle Class
          • Emoticon Class
          • FileExplorer Class
          • FileExplorerEventArgs Class
          • FileExplorerHolder Class
          • Floater Class
          • Flyout Class
          • FontInfo Class
          • Grid Class
          • GridCell Class
          • GridCellCollection Class
          • GridColumn Class
          • GridColumnCollection Class
          • GridColumnEventArgs Class
          • GridCommandEventArgs Class
          • GridItem Class
          • GridItemCollection Class
          • GridItemEventArgs Class
          • GridItemStyleSet Class
          • GridItemStyleSetCollection Class
          • ImageButtonInfo Class
          • ImageInfo Class
          • ImageZoom Class
          • InlineStyle Class
          • ListBox Class
          • ListBoxItem Class
          • ListBoxItemCollection Class
          • ListBoxItemContainer Class
          • ListItemEventArgs Class
          • LookItemCollection Class
          • MaskedEdit Class
          • MaskedEditColumn Class
          • MaskedEditSegment Class
          • MaskedEditSegmentCollection Class
          • MaskedEditValidator Class
          • Menu Class
          • MenuGroup Class
          • MenuItem Class
          • MenuItemCollection Class
          • MenuItemImages Class
          • MenuLookItemCollection Class
          • MsgBox Class
          • MsgBoxButton Class
          • MultiPage Class
          • MultiPageEventArgs Class
          • NavigationItem Class
          • NavigationItemCollection Class
          • NavigationItemEventArgs Class
          • NavigationItemGroup Class
          • NavigationItemImages Class
          • NavigationItemText Class
          • PageContextMenu Class
          • PageView Class
          • PageViewCollection Class
          • PathMapping Class
          • PathMappingCollection Class
          • PopupCalendar Class
          • ProgressBar Class
          • ProgressTaskEventArgs Class
          • RangeSlider Class
          • Rating Class
          • RowNumberColumn Class
          • Runtime Class
          • ScriptEvent Class
          • ScriptManager Class
          • Slide Class
          • SlideItem Class
          • SlideItemCollection Class
          • SlideItemEventArgs Class
          • SlideMenu Class
          • Slider Class
          • SliderBase Class
          • SliderLabel Class
          • SliderLabelCollection Class
          • SpecialLookIDs Class
          • SpellChecker Class
          • SpellCheckerDialog Class
          • SpellCheckerEventArgs Class
          • Splitter Class
          • SplitterPane Class
          • StaticColumn Class
          • TabItem Class
          • TabItemCollection Class
          • TabItemGroup Class
          • TabLookItemCollection Class
          • TabStrip Class
          • TemplatedPopup Class
          • TextBoxColumn Class
          • ToolBar Class
          • ToolBarEventArgs Class
          • ToolBarItem Class
          • ToolBarItemCollection Class
          • ToolTip Class
          • TreeLookNodeCollection Class
          • TreeNode Class
          • TreeNodeCheckStateChangedEventArgs Class
          • TreeNodeCollection Class
          • TreeNodeGroup Class
          • TreeNodeMovedEventArgs Class
          • TreeNodeRenameEventArgs Class
          • TreeView Class
          • TreeViewCheckBoxImages Class
          • TreeViewLineImages Class
          • TreeViewMargin Class
          • WebControl Class
          • WebControlBase Class
        • Structures
        • Enumerations
        • Delegates
      • EO.WebBrowser
      • EO.WebBrowser.DOM
      • EO.WebEngine
      • EO.WinForm
      • EO.Wpf
      • EO.Wpf.Gauge
      • EO.Wpf.Gauge.Shapes
      • EO.Wpf.Primitives
      • EO.Wpf.Themes.Aero
      • EO.Wpf.Themes.Classic
      • EO.Wpf.Themes.Luna
      • EO.Wpf.Themes.Metro
      • EO.Wpf.Themes.Royale
    • JavaScript API Reference
Table of Contents
DataFields Property

Specifies a list of fields used during data binding when binding to an ADO.NET data object. Use '|' to separate multiple fields.

Syntax
C#
Copy
 public virtual String DataFields { get; set; }
Remarks

Controls inheriting from BaseNavigator have hierarchical data structure. In order to do a successful binding, data in data source must be presented hierarchically. Some data source are not hierarchical, e.g, a single DataTable; and some data source are hierarchical, e.g, several DataTables with relationships in a DataSet. Therefore, DataFields property has different usage under the above two different scenarios:

When binding to a DataSet, since DataSet already contains hierarchical data, DataFields specifies a list of field names whose value will be used as item text.

When binding to DataTable, DataView or an object that implements IDataReader interface. because their data structures are not hierarchical, DataFields must be provided to abstract hierarchical data structure from those data source. For example, Data fields "Country|City|ZipCode" abstract hierarchical structure from the following DataTable (or DataView, IDataReader):

Country City ZipCode
U.S.A New York 10471
U.S.A New York 10471
Canada Toronto M1W2V6
U.K London W114BE

And results the following menu:

You can use a JOIN to easily return such data from a database.

By default, values in fields specified in DataFields will also be used to populate Html, however, you can change this mapping by providing your own DataBinding object through Bindings property.

DataFields is not used when bind to an object that implement IEnumerable.

Refer to data binding for more details.

See Also