XRControl.ExpressionBindings Property

Provides access to a control’s collection of expression bindings.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

[Browsable(false)]
public virtual ExpressionBindingCollection ExpressionBindings { get; }

VB.NET

<Browsable(False)>
Public Overridable ReadOnly Property ExpressionBindings As ExpressionBindingCollection

Property Value

Type	Description
ExpressionBindingCollection	An ExpressionBindingCollection object.

Remarks

You can create a binding expression to specify a control or parameter property. Create a ExpressionBinding object and set its properties:

• EventName - the event handler that evaluates the expression. Set this property to BeforePrint or PrintOnPage. If you omit this property, the expression is evaluated in the BeforePrint event.
• PropertyName - the property that the expression applies to.
• Expression - the expression.

See Data Binding Modes for more information.

The following code example illustrates how to specify an expression to a control’s property:

C#

// Create a label control.
XRLabel label = new XRLabel();
// Specify an expression that sets the label's Text to the current date. The expression is rendered within the BeforePrint event.
XRLabel.ExpressionBindings.Add (new ExpressionBinding("Text", "TODAY()"));
// Specify an expression that is rendered within the PrintOnPage event.
XRLabel.ExpressionBindings.Add (new ExpressionBinding("PrintOnPage","Font.Bold","true"));

VB.NET

' Create a label control.
Dim label As New XRLabel()
' Specify an expression that sets the label's Text to the current date. The expression is rendered within the BeforePrint event.
XRLabel.ExpressionBindings.Add(New ExpressionBinding("Text", "TODAY()"))
' Specify an expression that is rendered within the PrintOnPage event.
XRLabel.ExpressionBindings.Add(New ExpressionBinding("PrintOnPage","Font.Bold","true"))

The following code snippet demonstrates how to specify a custom expression for a label’s XRControl.Text property. This code assumes that a report is bound to a data source containing the UnitPrice and UnitsInStock fields.

C#

using DevExpress.XtraReports.UI;

public XtraReport1() {
    // ...
    ExpressionBinding expressionBinding = new ExpressionBinding("BeforePrint", "Text", "[UnitPrice]*[UnitsInStock]");
    xrLabel1.ExpressionBindings.Add(expressionBinding);
}

VB.NET

Imports DevExpress.XtraReports.UI

Public Sub New()
    ' ...
    Dim expressionBinding As New ExpressionBinding("BeforePrint", "Text", "[UnitPrice]*[UnitsInStock]")
    xrLabel1.ExpressionBindings.Add(expressionBinding)
End Sub