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

ExpressionBindingDescriptor Class

Allows you to manage properties in the Properties panel's Expressions tab in the End-User Report Designer.

Namespace: DevExpress.XtraReports.Expressions

Assembly: DevExpress.XtraReports.v18.2.dll


public static class ExpressionBindingDescriptor
Public Module ExpressionBindingDescriptor


The ExpressionBindingDescriptor class enables you to manage properties displayed in the Expressions tab, which is available in the Properties panel when the UserDesignerOptions.DataBindingMode is set to DataBindingMode.Expressions or DataBindingMode.ExpressionsAdvanced.

The ExpressionBindingDescriptor.HidePropertyDescriptions method allows you to remove an existing property from the End-User Report Designer's Expressions tab. The ExpressionBindingDescriptor.GetPropertyDescriptions method returns all available property descriptions for the specified report control.

To add a new property description to this tab, create a new ExpressionBindingDescription instance with the required settings and use the ExpressionBindingDescriptor.SetPropertyDescription method. Each description object contains information about 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.

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