ASPxTreeList.ParentFieldName Property

Gets or sets the data source field which contains parent node values.

Namespace: DevExpress.Web.ASPxTreeList

Assembly: DevExpress.Web.ASPxTreeList.v18.2.dll

Declaration

C#

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

VB.NET

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

Property Value

Type	Default	Description
String	String.Empty	A String value that specifies the parent field name.

Remarks

Since the ASPxTreeList control is designed to display information in a tree structure, its data source should meet certain requirements. If a data source contains flat data, two additional fields are necessary to build a tree structure.

• The first field must contain unique values. This field must be assigned to the ASPxTreeList.KeyFieldName property.
• The second field must contain key values of parent nodes for the current node. It should be assigned to the ParentFieldName property.

Note

The data types of the KeyField and ParentField fields must be the same.

Important

When the ASPxTreeList control is bound to a hierarchical data source (e.g. XmlDataSource), the ASPxTreeList.KeyFieldName and ParentFieldName properties are not in effect.

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-bind-aspxtreelist-to-xpo-data-e1288/CS/Default.aspx.cs#L12

ASPxTreeList1.KeyFieldName = "Oid";
ASPxTreeList1.ParentFieldName = "Parent!Key";
ASPxTreeList1.DataBind();

how-to-reload-grid-data-when-navigating-the-treelist-e934/CS/SyncWithGridOnUpdatePanel/Default.aspx.cs#L23

ASPxTreeList1.ParentFieldName = "ParentID";
ASPxTreeList1.EnableCallbacks = false;

how-to-use-a-single-aspxpopupcontrol-for-the-entire-application-t501713/CS/T501713/WebForm2.aspx.cs#L38

tree.DataBinding += (sender, e) => {
    (sender as ASPxTreeList).ParentFieldName = "Parent";
    (sender as ASPxTreeList).DataSource = Enumerable.Range(0, 10).Select(i => new { Id = i, Name = "Name" + i, Parent = i % 3 }).ToList();

VB.NET

how-to-bind-aspxtreelist-to-xpo-data-e1288/VB/Default.aspx.vb#L14

ASPxTreeList1.KeyFieldName = "Oid"
ASPxTreeList1.ParentFieldName = "Parent!Key"
ASPxTreeList1.DataBind()

how-to-reload-grid-data-when-navigating-the-treelist-e934/VB/SyncWithGridOnUpdatePanel/Default.aspx.vb#L25

ASPxTreeList1.ParentFieldName = "ParentID"
ASPxTreeList1.EnableCallbacks = False

how-to-use-a-single-aspxpopupcontrol-for-the-entire-application-t501713/VB/T501713/WebForm2.aspx.vb#L42

AddHandler tree.DataBinding, Sub(sender, e)
    TryCast(sender, ASPxTreeList).ParentFieldName = "Parent"
    TryCast(sender, ASPxTreeList).DataSource = Enumerable.Range(0, 10).Select(Function(i) New With {Key .Id = i, Key .Name = "Name" & i, Key .Parent = i Mod 3}).ToList()