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.

See Also

• Expression
• Telerik.Reporting.Binding
• Telerik.Reporting.BindingCollection