UserDesignerOptions.DataBindingMode Property

Specifies the binding mode used to provide dynamic content to reports.

Namespace: DevExpress.XtraReports.Configuration

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

public DataBindingMode DataBindingMode { get; set; }

VB.NET

Public Property DataBindingMode As DataBindingMode

Property Value

Type	Description
DataBindingMode	A DataBindingMode enumeration value.

Available values:

Name	Description
Bindings	The legacy data binding mode, in which providing any custom logic to the report requires report scripts.
Expressions	The default binding mode that allows you to provide expressions with restricted customization options (only the XRControl.BeforePrint event is available).
ExpressionsAdvanced	The binding mode that allows you to provide expressions in both the XRControl.BeforePrint and XRControl.PrintOnPage event handlers. See Use Variables for Event-Related Expressions.

Property Paths

You can access this nested property as listed below:

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

Remarks

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

Set the DataBindingMode property at the application’s startup to specify the default binding mode for an End-User Report Designer:

• WinForms

  C#

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

  VB.NET

  Module Program
      Private Sub Main()
          DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.DataBindingMode = 
              DevExpress.XtraReports.UI.DataBindingMode.ExpressionsAdvanced
          ' ...
      End Sub
  End Module
  

• WPF

  C#

  public partial class App : Application {
      protected override void OnStartup(StartupEventArgs e) {
          DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.DataBindingMode =
              DevExpress.XtraReports.UI.DataBindingMode.ExpressionsAdvanced;
          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.DataBindingMode =
               DevExpress.XtraReports.UI.DataBindingMode.ExpressionsAdvanced
          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.DataBindingMode =
              DevExpress.XtraReports.UI.DataBindingMode.ExpressionsAdvanced;
          //... 
      }
  }
  

  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.DataBindingMode = 
              DevExpress.XtraReports.UI.DataBindingMode.ExpressionsAdvanced
          ' ...
      End Sub
  End Class
  

See the Data Binding Modes document to learn about available binding modes.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DataBindingMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

reporting-web-object-data-source/CS/Reporting-How-To-Use-Object-Data-Source/WebForms/CS/Reporting_ObjectDS_WebForms/Global.asax.cs#L11

System.Web.Routing.RouteTable.Routes.MapPageRoute("defaultRoute", "", "~/Default.aspx");
DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.DataBindingMode = DevExpress.XtraReports.UI.DataBindingMode.Expressions;
DevExpress.XtraReports.Web.WebDocumentViewer.Native.WebDocumentViewerBootstrapper.SessionState = System.Web.SessionState.SessionStateBehavior.Default;

reporting-wpf-create-report-in-code/CS/RuntimeReportsApplication/MainWindow.xaml.cs#L92

// Bind the label to the CategoryName data field depending on the report's data binding mode.
if (Settings.Default.UserDesignerOptions.DataBindingMode == DataBindingMode.Bindings)
    labelDetail.DataBindings.Add("Text", report.DataSource, "queryCategories.CategoryName", "Category: {0}");

reporting-winforms-bind-to-csv-file/CS/BindingReportToCsvFile/Form1.cs#L52

// Specify the label's binding depending on the data binding mode.
if (Settings.Default.UserDesignerOptions.DataBindingMode == DataBindingMode.Bindings)
    label.DataBindings.Add("Text", null, "CategoryName");

reporting-winforms-calculated-field-runtime/CS/UsingCalculatedFields/Form1.cs#L36

// depending on the report's data binding mode.
if (Settings.Default.UserDesignerOptions.DataBindingMode == DataBindingMode.Bindings)
    report.FindControl("xrlabel3", true).DataBindings.Add("Text", null, "Products.myField", "{0:c2}");

reporting-winforms-bind-mdb-with-select-query/CS/RuntimeBindingToMdbDatabase/Form1.cs#L63

// Specify labels' bindings depending on the report's data binding mode.
if (Settings.Default.UserDesignerOptions.DataBindingMode == DataBindingMode.Bindings) {
    label1.DataBindings.Add("Text", null, "selectQuery.CategoryName");

VB.NET

reporting-web-object-data-source/CS/Reporting-How-To-Use-Object-Data-Source/WebForms/VB/Reporting_ObjectDS_WebForms/Global.asax.vb#L13

System.Web.Routing.RouteTable.Routes.MapPageRoute("defaultRoute", "", "~/Default.aspx")
DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.DataBindingMode = DevExpress.XtraReports.UI.DataBindingMode.Expressions
DevExpress.XtraReports.Web.WebDocumentViewer.Native.WebDocumentViewerBootstrapper.SessionState = System.Web.SessionState.SessionStateBehavior.Default

reporting-wpf-create-report-in-code/VB/RuntimeReportsApplication/MainWindow.xaml.vb#L101

' Bind the label to the CategoryName data field depending on the report's data binding mode.
If Settings.Default.UserDesignerOptions.DataBindingMode = DataBindingMode.Bindings Then
    labelDetail.DataBindings.Add("Text", report.DataSource, "queryCategories.CategoryName", "Category: {0}")

reporting-winforms-bind-to-csv-file/VB/BindingReportToCsvFile/Form1.vb#L38

' Specify the label's binding depending on the data binding mode.
If Settings.Default.UserDesignerOptions.DataBindingMode = DataBindingMode.Bindings Then
    label.DataBindings.Add("Text", Nothing, "CategoryName")

reporting-winforms-bind-excel-runtime/VB/BindingReportToExcelWorkbook/Form1.vb#L47

' Specify the label's binding depending on the data binding mode.
If Settings.Default.UserDesignerOptions.DataBindingMode = DataBindingMode.Bindings Then
    label.DataBindings.Add("Text", Nothing, "CategoryName")

reporting-winforms-calculated-field-runtime/VB/UsingCalculatedFields/Form1.vb#L34

' depending on the report's data binding mode.
If Settings.Default.UserDesignerOptions.DataBindingMode = DataBindingMode.Bindings Then
    report.FindControl("xrlabel3", True).DataBindings.Add("Text", Nothing, "Products.myField", "{0:c2}")