TreeListView.ParentFieldName Property

Gets or sets the name of the service field in a data source that contains parent node values. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v18.2.dll

Declaration

C#

public string ParentFieldName { get; set; }

VB.NET

Public Property ParentFieldName As String

Property Value

Type	Description
String	A String value that contains parent node values.

Remarks

To display data in a tree, a data source should contain two additional fields. The first field must contain unique values. Its name is specified by the TreeListView.KeyFieldName property. The second field must contain values that indicate parent nodes for the current node. Its name is specified by the TreeListView.ParentFieldName property. Columns bound to these fields are called service columns.

Note

The data types of the data source fields specified by the TreeListView.KeyFieldName and TreeListView.ParentFieldName properties, must be the same. These values (key and parent) cannot be equal for a node.

To learn more, see Binding to Self-Referential Data Structure.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ParentFieldName 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#

how-to-get-visible-items-in-viewmodel-when-working-with-treelistview-e4152/VB/FilteredData/MainWindow.xaml#L28

<my:MyGridControl.View>
    <my:MyTreeListView x:Name="treeListView1" ShowTotalSummary="True" CustomNodeFilter="treeListView1_CustomNodeFilter" VisibleData="{Binding FilteredData}"  KeyFieldName="ID" ParentFieldName="ParentID"/>
</my:MyGridControl.View>

calculating-totals-e3273/CS/DXTreeList_Totals/MainWindow.xaml#L10

<dxg:TreeListView Name="treeListView1" AutoWidth="True"
                  KeyFieldName="ID" ParentFieldName="ParentID"
                  ShowTotalSummary="True"/>

how-to-synchronize-the-dxtreelist-with-the-icollectionview-collectionviewsource-e3238/CS/TreeListControlViewModel/MainWindow.xaml#L28

<dxg:TreeListControl.View>
    <dxg:TreeListView x:Name="treeListView" AutoWidth="True" AllowEditing="False" KeyFieldName="Id" ParentFieldName="ParentId"/>
</dxg:TreeListControl.View>

iterating-through-nodes-via-tree-traversal-api-e3256/CS/DXTreeList_NodeTraversing/MainWindow.xaml#L17

<dxg:TreeListView Name="treeListView1" AutoWidth="True" ShowIndicator="False"
                  KeyFieldName="ID" ParentFieldName="ParentID">
    <!--<dxg:TreeListView.RootValue>

wpf-treelist-iterate-through-nodes-with-the-treelistnodeiterator/CS/WpfApplication1/MainWindow.xaml#L16

    <dxg:TreeListView Name="treeListView" AutoWidth="True"
                      KeyFieldName="ID" ParentFieldName="ParentID" />
</dxg:GridControl.View>