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.