Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

HierarchyPrintOptions.ChildListFieldName Property

Specifies the child list field that the report’s data exposes if it is recursive.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

[DefaultValue("")]
public string ChildListFieldName { get; set; }

#Property Value

Type Default Description
String String.Empty

The name of the field that stores a list of child data objects (records).

#Property Paths

You can access this nested property as listed below:

Object Type Path to ChildListFieldName
DetailBand
.HierarchyPrintOptions .ChildListFieldName

#Remarks

Set this property if your report’s data is recursive. Assign the collection of child objects (records) if they have the same type as the parent objects (records).

public class MyData {
  public MyData() {
    Children = new List<MyData>();
  }
  public List<MyData> Children { get; set; }
} 

After you specify the ChildListFieldName property, the report’s Detail band is printed in tree mode.

Note

Tree mode is supported for recursive data and data with ID-ParentID related fields. Specify either the ChildListFieldName property or the KeyFieldName-ParentFieldName property pair.

See Also