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.2.Web.dll

NuGet Package: DevExpress.Web.Reporting.Common

Declaration

C#

public virtual int MaxNestingLevelUpdate { get; }

VB.NET

Public Overridable ReadOnly Property MaxNestingLevelUpdate As Integer

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.

   C#

   using DevExpress.XtraReports.Web.ReportDesigner.Services;
   
     public class MyRefreshFieldListService : RefreshFieldListService
     {
         public override int MaxNestingLevelUpdate => 3;
   
     }
   

   VB.NET

   Imports DevExpress.XtraReports.Web.ReportDesigner.Services
   
     Public Class MyRefreshFieldListService
       Inherits RefreshFieldListService
   
       Public Overrides ReadOnly Property MaxNestingLevelUpdate() As Integer
         Get
           Return 3
         End Get
       End Property
   
     End Class
   

2. Register a custom service at the application’s startup.

   • ASP.NET Web Forms and ASP.NET MVC

     C#

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

     VB.NET

     Imports DevExpress.XtraReports.Web.ReportDesigner.Services
     
       Private Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
           DefaultReportDesignerContainer.Register(Of RefreshFieldListService, MyRefreshFieldListService)()
       End Sub
     

   • ASP.NET Core

     C#

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