Skip to main content

UserDesignerOptions.ConvertBindingsToExpressions Property

Specifies whether end-users are prompted to convert a legacy report to use expression bindings when opening it in the End-User Report Designer.

Namespace: DevExpress.XtraReports.Configuration

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

public PromptBoolean ConvertBindingsToExpressions { get; set; }

Property Value

Type Description
PromptBoolean

A PromptBoolean enumeration value.

Property Paths

You can access this nested property as listed below:

Object Type Path to ConvertBindingsToExpressions
ReportingSettings
.UserDesignerOptions .ConvertBindingsToExpressions
Settings
.UserDesignerOptions .ConvertBindingsToExpressions

Remarks

The ConvertBindingsToExpressions option defines whether and how to convert legacy reports to use the new binding mechanism when opening them in the Designer.

If this property is set to True, such reports are automatically converted to use expression bindings. If this property is set to False, legacy reports are opened without any changes.

If you select the Prompt value, users are prompted to convert legacy reports to use the new binding mode.

The following image demonstrates the dialog that appears in Visual Studio at design time.

convert-bingings-to-expressions-dialog

The DataBindingMode property is available in the Report Designer Options dialog in Visual Studio at design time.

For End-User Report Designers, set the ConvertBindingsToExpressions property at the application’s startup as shown below:

  • WinForms

    static class Program {
        static void Main() {
            DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.ConvertBindingsToExpressions =
                   DevExpress.XtraReports.UI.PromptBoolean.True;
            // ...
        }
    }
    
  • WPF

    public partial class App : Application {
        protected override void OnStartup(StartupEventArgs e) {
            DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.ConvertBindingsToExpressions =
                   DevExpress.XtraReports.UI.PromptBoolean.True;
            base.OnStartup(e);
        }
    }
    
  • ASP.NET

    public class Global : System.Web.HttpApplication {
        protected void Application_Start(Object sender, EventArgs e) {
            DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.ConvertBindingsToExpressions =
                   DevExpress.XtraReports.UI.PromptBoolean.True;
            //... 
        }
    }
    

See Data Binding Modes for more information.

See Also