Skip to main content

RefreshFieldListService.MaxNestingLevelUpdate Property

Specifies the maximum nesting level of fields whose data are requested when the Field List is refreshed.

Namespace: DevExpress.XtraReports.Web.ReportDesigner.Services

Assembly: DevExpress.XtraReports.v24.1.Web.dll

NuGet Package: DevExpress.Web.Reporting.Common

Declaration

public virtual int MaxNestingLevelUpdate { get; }

Property Value

Type Description
Int32

An integer that is the field nesting level whose default value is 5. If the value is 0 (zero), then the root level in the Field List will not expand.

Remarks

The following code snippet demonstrates how minimize the number of requests required to refresh the Field List.

  1. Create a descendant of the RefreshFieldListService class and override the MaxNestingLevelUpdate property.

    using DevExpress.XtraReports.Web.ReportDesigner.Services;
    
      public class MyRefreshFieldListService : RefreshFieldListService
      {
          public override int MaxNestingLevelUpdate => 3;
    
      }
    
  2. Register a custom service at the application’s startup.

    • ASP.NET Web Forms and ASP.NET MVC

      using DevExpress.XtraReports.Web.ReportDesigner.Services;
      
        void Application_Start(object sender, EventArgs e) {
          DefaultReportDesignerContainer.Register<RefreshFieldListService, MyRefreshFieldListService>();
        }
      
    • ASP.NET Core

      using DevExpress.XtraReports.Web.ReportDesigner.Services;
      
      var builder = WebApplication.CreateBuilder(args);
      
      builder.Services.AddSingleton<RefreshFieldListService, MyRefreshFieldListService>();
      
      var app = builder.Build();
      
See Also