TreeListNodeBase.Content Property

Gets or sets the node’s content.

Namespace: DevExpress.Data.TreeList

Assembly: DevExpress.Data.v24.1.dll

NuGet Package: DevExpress.Data

Declaration

C#

public virtual object Content { get; set; }

VB.NET

Public Overridable Property Content As Object

Property Value

Type	Description
Object	An object that specifies the node’s content.

Remarks

Nodes can be specified by objects of different types. The only requirement is that these data objects should have common fields (columns).

Example

This example shows how to manually create a tree (unbound mode). It is shown how to create nodes in XAML and code.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/wpf-treelist-create-unbound-tree

MainWindow.xaml.cs

using System;
using System.Windows;
using DevExpress.Xpf.Grid;

namespace TreeListView_UnboundMode {
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
            BuildTree();
            treeListView1.ExpandAllNodes();
        }

        private void BuildTree() {
            TreeListNode rootNode = CreateRootNode(new ProjectObject() { Name = "Project: Stanton", Executor = "Nicholas Llams" });
            TreeListNode childNode = CreateChildNode(rootNode, new StageObject() { Name = "Information Gathering", Executor = "Ankie Galva" });
            CreateChildNode(childNode, new TaskObject() { Name = "Design", Executor = "Reardon Felton", State = "In progress" });
        }

        private TreeListNode CreateRootNode(object dataObject) {
            TreeListNode rootNode = new TreeListNode(dataObject);
            treeListView1.Nodes.Add(rootNode);
            return rootNode;
        }

        private TreeListNode CreateChildNode(TreeListNode parentNode, object dataObject) {
            TreeListNode childNode = new TreeListNode(dataObject);
            parentNode.Nodes.Add(childNode);
            return childNode;
        }
    }

    public class StageObject {
        public String Name { get; set; }
        public string Executor { get; set; }
    }

    public class ProjectObject {
        public String Name { get; set; }
        public string Executor { get; set; }
    }

    public class TaskObject {
        public String Name { get; set; }
        public string Executor { get; set; }
        public string State { get; set; }
    }
}

MainWindow.xaml

<Window x:Class="TreeListView_UnboundMode.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="350" Width="525"
        xmlns:dxg="http://schemas.devexpress.com/winfx/2008/xaml/grid"
        xmlns:local="clr-namespace:TreeListView_UnboundMode">
    <Grid>
        <dxg:GridControl Name="grid">
            <dxg:GridControl.Columns>
                <dxg:GridColumn FieldName="Name" />
                <dxg:GridColumn FieldName="Executor" />
                <dxg:GridColumn FieldName="State" />
            </dxg:GridControl.Columns>
            <dxg:GridControl.View>
                <dxg:TreeListView Name="treeListView1" AutoWidth="True">
                    <dxg:TreeListView.Nodes>
                        <dxg:TreeListNode>
                            <dxg:TreeListNode.Content>
                                <local:ProjectObject Name="Project: Betaron" Executor="Destiny Tabisola" />
                            </dxg:TreeListNode.Content>
                            <dxg:TreeListNode.Nodes>
                                <dxg:TreeListNode>
                                    <dxg:TreeListNode.Content>
                                        <local:StageObject Name="Development" Executor="Kairra Hogg" />
                                    </dxg:TreeListNode.Content>
                                    <dxg:TreeListNode.Nodes>
                                        <dxg:TreeListNode>
                                            <dxg:TreeListNode.Content>
                                                <local:TaskObject Name="Coding" Executor="Sabato Durley" State="Not Started" />
                                            </dxg:TreeListNode.Content>
                                        </dxg:TreeListNode>
                                    </dxg:TreeListNode.Nodes>
                                </dxg:TreeListNode>
                            </dxg:TreeListNode.Nodes>
                        </dxg:TreeListNode>
                    </dxg:TreeListView.Nodes>
                </dxg:TreeListView>
            </dxg:GridControl.View>
        </dxg:GridControl>
    </Grid>
</Window>

MainWindow.xaml.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Windows
Imports DevExpress.Xpf.Grid

Namespace TreeListView_UnboundMode
    ''' <summary>
    ''' Interaction logic for MainWindow.xaml
    ''' </summary>
    Partial Public Class MainWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
            BuildTree()
            treeListView1.ExpandAllNodes()
        End Sub

        Private Sub BuildTree()
            Dim rootNode As TreeListNode = CreateRootNode(New ProjectObject() With {.Name = "Project: Stanton", .Executor = "Nicholas Llams"})
            Dim childNode As TreeListNode = CreateChildNode(rootNode, New StageObject() With {.Name = "Information Gathering", .Executor = "Ankie Galva"})
            CreateChildNode(childNode, New TaskObject() With {.Name = "Design", .Executor = "Reardon Felton", .State = "In progress"})
        End Sub

        Private Function CreateRootNode(ByVal dataObject As Object) As TreeListNode
            Dim rootNode As New TreeListNode(dataObject)
            treeListView1.Nodes.Add(rootNode)
            Return rootNode
        End Function

        Private Function CreateChildNode(ByVal parentNode As TreeListNode, ByVal dataObject As Object) As TreeListNode
            Dim childNode As New TreeListNode(dataObject)
            parentNode.Nodes.Add(childNode)
            Return childNode
        End Function
    End Class

    Public Class StageObject
        Private privateName As String
        Public Property Name() As String
            Get
                Return privateName
            End Get
            Set(ByVal value As String)
                privateName = value
            End Set
        End Property
        Private privateExecutor As String
        Public Property Executor() As String
            Get
                Return privateExecutor
            End Get
            Set(ByVal value As String)
                privateExecutor = value
            End Set
        End Property
    End Class

    Public Class ProjectObject
        Private privateName As String
        Public Property Name() As String
            Get
                Return privateName
            End Get
            Set(ByVal value As String)
                privateName = value
            End Set
        End Property
        Private privateExecutor As String
        Public Property Executor() As String
            Get
                Return privateExecutor
            End Get
            Set(ByVal value As String)
                privateExecutor = value
            End Set
        End Property
    End Class

    Public Class TaskObject
        Private privateName As String
        Public Property Name() As String
            Get
                Return privateName
            End Get
            Set(ByVal value As String)
                privateName = value
            End Set
        End Property
        Private privateExecutor As String
        Public Property Executor() As String
            Get
                Return privateExecutor
            End Get
            Set(ByVal value As String)
                privateExecutor = value
            End Set
        End Property
        Private privateState As String
        Public Property State() As String
            Get
                Return privateState
            End Get
            Set(ByVal value As String)
                privateState = value
            End Set
        End Property
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Content 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-emulate-binding-to-the-isexpanded-property-of-the-treelistnode-t127638/CS/DevExpress.Example04/BindableExpandingBehavior.cs#L27

while(iterator.MoveNext()) {
    this.SubscribeObject(iterator.Current.Content);
    if(iterator.Current.HasChildren) {

wpf-treelist-load-nodes-dynamically/CS/DynamicNodeLoading/MainWindow.xaml.cs#L50

private void InitFiles(TreeListNode treeListNode) {
    FileSystemItem item = treeListNode.Content as FileSystemItem;
    if (item == null) return;

wpf-spreadsheet-chart-api/CS/SpreadsheetWPFChartAPISamples/MainWindow.xaml.cs#L176

if (e.Node.HasChildren && e.Node.Content is CodeExampleGroup) {
    e.DisplayText = (e.Node.Content as CodeExampleGroup).Name;

wpf-spreadsheet-pivot-table-api-examples/CS/SpreadsheetWPFPivotTableExamples/MainWindow.xaml.cs#L198

if (e.Node.HasChildren && e.Node.Content is CodeExampleGroup)
{

wpf-richedit-document-api/CS/DXRichEditControlAPISample/MainWindow.xaml.cs#L174

if (e.Node.HasChildren && e.Node.Content is CodeExampleGroup) {
    e.DisplayText = (e.Node.Content as CodeExampleGroup).Name;

VB.NET

how-to-emulate-binding-to-the-isexpanded-property-of-the-treelistnode-t127638/VB/DevExpress.Example04/BindableExpandingBehavior.vb#L32

Do While iterator.MoveNext()
    Me.SubscribeObject(iterator.Current.Content)
    If iterator.Current.HasChildren Then

wpf-treelist-load-nodes-dynamically/VB/DynamicNodeLoading/MainWindow.xaml.vb#L53

Private Sub InitFiles(ByVal treeListNode As TreeListNode)
    Dim item As FileSystemItem = TryCast(treeListNode.Content, FileSystemItem)
    If item Is Nothing Then Return

wpf-spreadsheet-chart-api/VB/SpreadsheetWPFChartAPISamples/MainWindow.xaml.vb#L191

If e.Node.HasChildren AndAlso TypeOf e.Node.Content Is CodeExampleGroup Then
    e.DisplayText = (TryCast(e.Node.Content, CodeExampleGroup)).Name

wpf-spreadsheet-pivot-table-api-examples/VB/SpreadsheetWPFPivotTableExamples/MainWindow.xaml.vb#L194

If e.Node.HasChildren AndAlso TypeOf e.Node.Content Is CodeExampleGroup Then
    e.DisplayText = (TryCast(e.Node.Content, CodeExampleGroup)).Name

wpf-richedit-document-api/VB/DXRichEditControlAPISample/MainWindow.xaml.vb#L187

If e.Node.HasChildren AndAlso TypeOf e.Node.Content Is CodeExampleGroup Then
    e.DisplayText = (TryCast(e.Node.Content, CodeExampleGroup)).Name