New to Telerik Reporting? Download free 30-day trial

Bindings Overview

By default only a certain number of report items and properties can handle expression values. The simple binding between the other properties of a report item and an expression is accomplished by adding Binding objects to the Bindings collection.

For example, you can bind the Style.BackgroundColor property of a TextBox item to an expression =Fields.CarColor that when evaluated returns an object of type appropriate for the property, System.Drawing.Color in this case. In certain cases using user-defined functions to perform appropriate type conversions should be considered.

When constructing a Binding instance with Binding constructor, you must specify:

  • the Name of the property to bind; alternatively a period-delimited navigation path can be used to reference a property down the object hierarchy. For example the following navigation paths define valid properties:

    • DataSource
    • Style.BackgroundColor
    • Style.Font.Name Only write-enabled properties can be set through binding expressions, so read-only properties are not suitable for data-binding.

    Not all item properties support expression bindings. Please refer to the Reporting API Reference to check if a property supports binding.

  • an Expression that will return the value for the property when evaluated at runtime.

Edit Bindings Wizard

See Also

In this article