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.v18.1.dll

Syntax

public PromptBoolean ConvertBindingsToExpressions { get; set; }

Returns

Type Description
PromptBoolean

A PromptBoolean enumeration value.

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