Skip to main content
BuyLog In
WinForms Controls
Search in…
Docs > Common Features > Data Binding Common Concepts > Add Unbound Data to a Data-Aware Control (XtraGrid)
All docs
V23.2
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

Add Unbound Data to a Data-Aware Control (XtraGrid)

  • 2 minutes to read

In most cases data-aware DevExpress .NET controls contain bound columns/fields that display data from bound data sources. In Grid Control, it is possible to add unbound columns/fields that can display arbitrary data. Unbound columns are not bound to any field in a data source. You can provide data for these fields by specifying a formula (string expression) used to evaluate values or by handling an event.

Tip

If you want to bind data without the currently existing ready-to-use source, use the UnboundSource component.

An unbound column/field must meet the following two requirements:

  • its FieldName property must be set to a unique value and not refer to any field in the control’s data source;
  • its UnboundDataType (or UnboundType) property must be set to the type of data the column/field is supposed to display. This property determines the default cell editor, value alignment, sorting and validity rules.

There is no difference between working with bound and unbound columns/fields. Unbound columns can be sorted, grouped and filtered in the same manner as bound columns. They also support summaries. When printing or exporting a control, the contents of unbound columns will be printed/exported as well.

Providing data using expressions

For an unbound column/field, you can specify a formula (string expression) that will be used to evaluate values for this field. Use the column’s UnboundExpression property to specify an expression. At design time, you can invoke an Expression Editor via the Property Grid to build the expression. The Expressions section describes a syntax for creating formulas in code.

Expressions do not allow data entered by end-users to be saved. To create unbound columns and allow data entered by end-users to be saved, you need to provide data for unbound columns using an event (see below).

Providing data via an event

A specific event fires for unbound columns/fields, allowing data to be provided. In addition, in the Grid Control, this event allows data entered by an end-user to be saved. In the Grid Control control, use the ColumnView.CustomUnboundColumnData event. This event is raised for each cell within unbound columns/fields.

See Also