GridLevelNodeCollection.Add(String, BaseView) Method

Creates a new node and appends it to the current collection.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

public GridLevelNode Add(
    string relationName,
    BaseView template
)

VB.NET

Public Function Add(
    relationName As String,
    template As BaseView
) As GridLevelNode

Parameters

Name	Type	Description
relationName	String	A string specifying the name of the relationship that the new node will represent. This parameter’s value is used to initialize the node’s GridLevelNode.RelationName property.
template	BaseView	A BaseView descendant representing the pattern View to associate with the specified relationship. This parameter’s value is used to initialize the node’s GridLevelNode.LevelTemplate property.

Returns

Type	Description
GridLevelNode	A GridLevelNode object representing the created node.

Remarks

The Add method creates and initializes a new node with the specified relationship name and pattern View. The node is then appended to the collection. The order of the nodes in the collection determines the order in which the corresponding master-detail relationships will be displayed in the XtraGrid. To add a node at a specific position use the GridLevelNodeCollection.Insert method.

If the collection already contains a node whose GridLevelNode.RelationName property matches the relationName parameter’s value, then a new node will not be created. Instead the existing node’s GridLevelNode.LevelTemplate property will be set to the View provided by the template parameter.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Add(String, BaseView) 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-hide-expand-collapse-buttons-for-master-rows-without-detail-records-e3114/CS/A899Example/Form1.cs#L41

GridView detailGridView = new GridView(gridControl1);
gridControl1.LevelTree.Nodes.Add("Models", detailGridView);
detailGridView.PopulateColumns(dataSet.Tables["DetailTable"]);

providing-custom-pattern-views-to-represent-individual-master-detail-relationships-e3861/CS/Form1.cs#L29

    // Associate the pattern View with the "CustomRelation" name
    gridControl1.LevelTree.Nodes.Add("CustomRelation", customPatternView);
}

VB.NET

how-to-hide-expand-collapse-buttons-for-master-rows-without-detail-records-e3114/VB/A899Example/Form1.vb#L39

Dim detailGridView As New GridView(gridControl1)
gridControl1.LevelTree.Nodes.Add("Models", detailGridView)
detailGridView.PopulateColumns(dataSet.Tables("DetailTable"))

how-to-hide-certain-records-in-the-xtragrids-detail-views-e684/VB/Form1.vb#L36

Dim gridView2 As New GridView(gridControl1)
gridControl1.LevelTree.Nodes.Add("CustomersOrders", gridView2)

providing-custom-pattern-views-to-represent-individual-master-detail-relationships-e3861/VB/Form1.vb#L31

    ' Associate the pattern View with the "CustomRelation" name
    gridControl1.LevelTree.Nodes.Add("CustomRelation", customPatternView)
End Sub