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.v19.1.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Core

Declaration

C#

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

VB.NET

<DefaultValue("")>
Public Property ChildListFieldName As String

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).

C#

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

VB.NET

Public Class TestObjectZeroFormatter2
  Public Sub New()
    Children = New List(Of TestObjectZeroFormatter)()
  End Sub
  <Index(0)>
  Public Overridable Property String() As String

  <Index(1)>
  Public Overridable Property Children() As List(Of TestObjectZeroFormatter)
End Class

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.