UserDesignerOptions.DataBindingMode Property

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

Namespace: DevExpress.XtraReports.Configuration

Assembly: DevExpress.XtraReports.v19.2.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.

Property Paths

You can access this nested property as listed below:

Object Type	Path to 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_how-to-create-a-hierarchical-master-detail-datasource-e137/CS/Form1.cs#L58

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

reporting-winforms-bind-mdb-with-custom-query/CS/RuntimeBindingToMdbDatabase/Form1.cs#L56

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

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

// 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-Custom-Parameter-Editor-Mvc/CS/CustomReportParameterType/Global.asax.cs#L19

protected void Application_Start() {
    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_How-to-customize-the-document-viewer-toolbar/CS/DXWebApplication1/Global.asax.cs#L10

System.Web.Routing.RouteTable.Routes.MapPageRoute("defaultRoute", "", "~/Viewer.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;

VB.NET

Reporting_how-to-create-a-hierarchical-master-detail-datasource-e137/VB/Form1.vb#L60

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

reporting-winforms-bind-mdb-with-custom-query/VB/RuntimeBindingToMdbDatabase/Form1.vb#L50

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

reporting-winforms-filter-report-data-query/VB/QueryParametersRuntime/XtraReport1.vb#L38

' Bind report controls to appropriate data fields depending on the report's data binding mode.
If Settings.Default.UserDesignerOptions.DataBindingMode = DataBindingMode.Bindings Then
    xrLabel1.DataBindings.Add("Text", ds, "Products.CategoryID")

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

' 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-Custom-Parameter-Editor-Mvc/VB/CustomReportParameterType/Global.asax.vb#L21

Protected Sub Application_Start()
    DevExpress.XtraReports.Configuration.Settings.Default.UserDesignerOptions.DataBindingMode = DevExpress.XtraReports.UI.DataBindingMode.Expressions
    DevExpress.XtraReports.Web.WebDocumentViewer.Native.WebDocumentViewerBootstrapper.SessionState = System.Web.SessionState.SessionStateBehavior.Default