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

C#

public PromptBoolean ConvertBindingsToExpressions { get; set; }

VB.NET

Public Property ConvertBindingsToExpressions As PromptBoolean

Property Value

Type	Description
PromptBoolean	A PromptBoolean enumeration value.

Available values:

Name	Description
False	Legacy reports are not converted to use expression bindings.
True	Legacy reports are automatically converted to use expression bindings.
Prompt	Users are prompted to convert legacy reports to use expression bindings.

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.

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

  C#

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

  VB.NET

  Module Program
      Private Sub Main()
          DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.ConvertBindingsToExpressions = 
                 DevExpress.XtraReports.UI.PromptBoolean.True
          ' ...
      End Sub
  End Module
  

• WPF

  C#

  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);
      }
  }
  

  VB.NET

  Public Partial Class App
      Inherits Application
      Protected Overrides Sub OnStartup(ByVal e As StartupEventArgs)
          DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.ConvertBindingsToExpressions = 
                 DevExpress.XtraReports.UI.PromptBoolean.True
          MyBase.OnStartup(e)
      End Sub
  End Class
  

• ASP.NET

  C#

  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;
          //... 
      }
  }
  

  VB.NET

  Public Class [Global]
      Inherits System.Web.HttpApplication
      Protected Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
          DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.ConvertBindingsToExpressions = 
                 DevExpress.XtraReports.UI.PromptBoolean.True
          ' ...
      End Sub
  End Class
  

See Data Binding Modes for more information.