A newer version of this page is available. Switch to the current version.

ExpressionBindingDescription Class

Provides information about a property displayed in the Properties panel's Expressions tab in the End-User Report Designer.

Namespace: DevExpress.XtraReports.Expressions

Assembly: DevExpress.XtraReports.v18.2.dll


public class ExpressionBindingDescription
Public Class ExpressionBindingDescription


The ExpressionBindingDescription class stores information about a property displayed in the Expressions tab, which is available in the Properties panel when the UserDesignerOptions.DataBindingMode is set to DataBindingMode.Expressions or DataBindingMode.ExpressionsAdvanced.

This information includes the list of events in which the property is available (ExpressionBindingDescription.EventNames), the property category (ExpressionBindingDescription.ScopeName), the collection of inner properties in a case of the complex property (ExpressionBindingDescription.BindableProperties) and other settings.

To add a new property description to the End-User Report Designer's Expressions tab, create a new ExpressionBindingDescription instance with the required settings and use the ExpressionBindingDescriptor.SetPropertyDescription method. The ExpressionBindingDescriptor.HidePropertyDescriptions method allows you to remove an existing property from this tab.

The following code sample demonstrates how to hide the Tag property for the XRLabel control and add the Value property to a new custom category at the tab's first position.

using DevExpress.XtraReports.Expressions;
// ...

ExpressionBindingDescriptor.HidePropertyDescriptions(typeof(XRLabel), "Tag");
ExpressionBindingDescription myDescription = new ExpressionBindingDescription(
    new string[] { "BeforePrint" }, 0, new string[0], "My category");
ExpressionBindingDescriptor.SetPropertyDescription(typeof(XRLabel), "Value", myDescription);

The following image shows the resulting Expressions tab.



See Also