Skip to main content
BuyLog In
WinForms Controls
Search in…
Docs > Common Features > Data Binding Common Concepts > Obtaining Fields Available in Data Source
All docs
V24.1
WinForms Controls
.NET/.NET Core Support
Prerequisites
What's Installed
Build an Application
Controls and Libraries
Common Features
Application Appearance and Skin Colors
Data Binding Common Concepts
How to: Bind GridControl to Database and Implement Master-Detail Mode at Design Time
How to: Bind a Control to a Database at Runtime
How to: Bind a Control to Data Created at Runtime
How to: Bind a Control to Data in an XML File
Traditional Data Binding Methods
Data Source Configuration Wizard
Data Binding Mechanism in ADO.NET
Binding Controls to XML Data
Binding Controls to Data Created at Runtime
Add Unbound Data to a Data-Aware Control (XtraGrid)
Binding to Excel Data Sources
Binding to LINQ to SQL Classes
Unbound Sources
Binding to Entity Framework Core
Binding to OData
Bind to MongoDB Data
Bind to JSON Data
Bind to XPO Data
Bind to Azure SQL Database
Binding to SQL Data
Data Annotation Attributes
How to: Add Virtual Rows Using the UnboundSource Component
Obtaining Fields Available in Data Source
Data Source Wizard
Graphics Performance and High DPI
HTML and CSS Support
Data Controls
Expressions
Behaviors
Data Filtering and Search
Find Panel Syntax
Formatting Values
HTML-inspired Text Formatting
Menus
Context Buttons
Hints and Tooltips
Save and Restore Layouts of DevExpress Controls
Clipboard
Version Compatibility: Default Property Values
Scaffolding Wizard
Security Considerations
UI Templates
Desktop & Web App UI Framework (Powered by EF Core)
Get More Help
API Reference
Download CHM

Obtaining Fields Available in Data Source

  • 2 minutes to read

Data-aware controls (e.g., Grid Control and XtraTreeList) can be bound to various data sources (e.g., BindingList<T>, List<T>, IList and ITypedList). When bound to a data source, the control needs to determine fields (properties) available in the data source that can potentially provide data for columns. For instance, information on available fields allows for automatic column creation.

Information on the fields available in the data source is retrieved as follows.

  1. If the data source implements the ITypedList interface, this information is obtained using the methods of this interface.
  2. If the data source provides an indexer [], available properties in the data source match public properties provided by the indexer’s return type.
  3. If the data source derives from the List<T> type, available properties in the data source are those exposed by the generic type T.

  4. If the data source implements the IList interface, the first item is retrieved from the IList, and this item’s public properties will determine the properties available in the data source for a data-aware control.

    Note

    Information on the first item’s properties is retrieved only when assigning the data source to the data-aware control. Ensure that the data source contains at least one item of a target type prior to binding the data source to the control.