ASPxTreeList.AppendNode(Object, TreeListNode) Method

Creates a new node and appends it to the TreeListNode.ChildNodes collection of the specified node.

Namespace: DevExpress.Web.ASPxTreeList

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

NuGet Package: DevExpress.Web

Declaration

C#

public TreeListNode AppendNode(
    object keyObject,
    TreeListNode parentNode
)

VB.NET

Public Function AppendNode(
    keyObject As Object,
    parentNode As TreeListNode
) As TreeListNode

Parameters

Name	Type	Description
keyObject	Object	An object that uniquely identifies the new node.
parentNode	TreeListNode	A TreeListNode object that owns the new node. If null (Nothing in Visual Basic) the new node is added to the Root.

Returns

Type	Description
TreeListNode	A TreeListNode object that represents the new node.

Remarks

The AppendNode method should be used when the ASPxTreeList functions in unbound mode.

Example

This example shows how to create a simple tree when the ASPxTreeList functions in unbound mode. New nodes are created and added to the ASPxTreeList via the ASPxTreeList.AppendNode method.

Columns can be created at design time or in code. For detailed information, see Creating Columns and Binding Them to Data Fields.

The image below shows the result:

C#

using DevExpress.Web.ASPxTreeList;

protected void Page_Load(object sender, EventArgs e) {
    CreateTree();
}

void CreateTree() {
    TreeListNode parentNode = CreateNodeCore(0, "<b>Local Folders</b>", null);
    CreateNodeCore(1, "Inbox", parentNode);
    CreateNodeCore(2, "Outbox", parentNode);
    CreateNodeCore(3, "Sent Items", parentNode);
    CreateNodeCore(4, "Deleted Items", parentNode);
    TreeListNode searchFolders = CreateNodeCore(5, "<b>Search Folders</b>", null);
    CreateNodeCore(6, "Categorized Mail", searchFolders);
    CreateNodeCore(7, "Large Mail", searchFolders);
}

TreeListNode CreateNodeCore(int key, string text, TreeListNode parentNode) {
    TreeListNode node = ASPxTreeList1.AppendNode(key, parentNode);
    node["Folder"] = text;
    return node;
}

VB.NET

Imports DevExpress.Web.ASPxTreeList

Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
    CreateTree()
End Sub

Sub CreateTree()
    Dim parentNode As TreeListNode = CreateNodeCore(0, "<b>Local Folders</b>", Nothing)
    CreateNodeCore(1, "Inbox", parentNode)
    CreateNodeCore(2, "Outbox", parentNode)
    CreateNodeCore(3, "Sent Items", parentNode)
    CreateNodeCore(4, "Deleted Items", parentNode)
    Dim searchFolders As TreeListNode = CreateNodeCore(5, "<b>Search Folders</b>", Nothing)
    CreateNodeCore(6, "Categorized Mail", searchFolders)
    CreateNodeCore(7, "Large Mail", searchFolders)
End Sub

Function CreateNodeCore(ByVal key As Integer, ByVal nodeText As String,_
ByVal parentNode As TreeListNode) As TreeListNode
    Dim node As TreeListNode = ASPxTreeList1.AppendNode(key, parentNode)
    node("Folder") = nodeText
    Return node
End Function

ASPX

<dxwtl:ASPxTreeList ID="ASPxTreeList1" runat="server" AutoGenerateColumns="False"
    Width="300px">
    <Columns>
        <dxwtl:TreeListTextColumn FieldName="Folder" VisibleIndex="0">
            <PropertiesTextEdit EncodeHtml="False">
            </PropertiesTextEdit>
        </dxwtl:TreeListTextColumn>
    </Columns>
</dxwtl:ASPxTreeList>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AppendNode(Object, TreeListNode) method.

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-define-a-cell-template-that-is-visible-or-hidden-based-on-the-node-it-belongs-to-e404/CS/OptionalCellTemplates/Default.aspx.cs#L18

nodeRoot.SetValue("Column1", "root");
TreeListNode nodeChild = ASPxTreeList1.AppendNode(2, nodeRoot);
nodeChild.SetValue("Column1", "child");

treelist-how-to-drag-and-drop-nodes-between-two-treelists-t137663/CS/WebApplication1/Models/ModelProvider.cs#L33

foreach(XmlElement element in xmlNode.ChildNodes) {
    TreeListNode child = tree.AppendNode(element.GetAttribute("key"), node);
    BindCore(tree, child, element);

VB.NET

how-to-define-a-cell-template-that-is-visible-or-hidden-based-on-the-node-it-belongs-to-e404/VB/OptionalCellTemplates/Default.aspx.vb#L20

nodeRoot.SetValue("Column1", "root")
Dim nodeChild As TreeListNode = ASPxTreeList1.AppendNode(2, nodeRoot)
nodeChild.SetValue("Column1", "child")

treelist-how-to-drag-and-drop-nodes-between-two-treelists-t137663/VB/MvcTreeListDragDrop/Models/ModelProvider.vb#L41

For Each element As XmlElement In xmlNode.ChildNodes
    Dim child As TreeListNode = tree.AppendNode(element.GetAttribute("key"), node)
    BindCore(tree, child, element)