DataControlDetailDescriptor.DataControl Property

Gets or sets the GridControl that displays detail data.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v24.2.Core.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public DataControlBase DataControl { get; set; }

VB.NET

Public Property DataControl As DataControlBase

Property Value

Type	Description
DataControlBase	A GridControl that displays detail data. Although the property type is DataControlBase, it currently only accepts GridControl objects and otherwise, throws exceptions.

Remarks

DataControlDetailDescriptor was specifically designed for tight master and detail view integration. In the current version, this kind of integration has been implemented only between two TableView objects. This means that you can only assign a GridControl to the DataControl property and that a detail grid control can only use a TableView to present data. In other cases, exceptions will be thrown.

The data binding for the detail grid is specified by the DataControlDetailDescriptor.ItemsSourcePath property.

Once you’ve assigned a GridControl to this property and specified the data binding, customize it’s setting to change the detail grid’s appearance and behavior. Note also that detail grids are integrated into the master grid’s Group Panel, Filter Panel and other UI Elements. The detail is identified in those elements by the string representation of the DataViewBase.DetailHeaderContent property value.

Related GitHub Examples

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

XAML

wpf-data-grid-display-detail-content-in-tabs/CS/WpfApplication18/MainWindow.xaml#L19

<dxg:DataControlDetailDescriptor ItemsSourcePath="Orders">
    <dxg:DataControlDetailDescriptor.DataControl>
        <dxg:GridControl AutoGenerateColumns="AddNew">

wpf-data-grid-display-chart-control-in-grid-details/CS/WpfApplication19/MainWindow.xaml#L65

<dxg:DataControlDetailDescriptor ContentTemplate="{StaticResource ContentDetail}" ItemsSourcePath="Orders"  x:Name="detail1">
    <dxg:DataControlDetailDescriptor.DataControl>
        <dxg:GridControl AutoGenerateColumns="AddNew">

wpf-data-grid-expand-and-collapse-master-rows/CS/WpfApplication21/MainWindow.xaml#L18

<dxg:DataControlDetailDescriptor ItemsSourcePath="Orders">
    <dxg:DataControlDetailDescriptor.DataControl>
        <dxg:GridControl AutoGenerateColumns="AddNew">

C#

wpf-data-grid-bind-master-and-detail-focused-rows-to-viewmodel-properties/CS/UpdateMasterDetailFocusedRowBehavior.cs#L96

{
    tempGrid = (GridControl)detailDescriptor.DataControl;
    nestingLevel++;

wpf-data-grid-display-chart-control-in-grid-details/CS/WpfApplication19/MainWindow.xaml.cs#L62

DataControlDetailDescriptor dataControlDetail = new DataControlDetailDescriptor();
dataControlDetail.DataControl = SetupDetailGrid();
dataControlDetail.ItemsSourcePath = "Orders";

wpf-data-grid-display-custom-content-in-grid-details/CS/WpfApplication18/MainWindow.xaml.cs#L59

GridControl detailGrid = new GridControl();
dataControlDetail.DataControl = detailGrid;
detailGrid.AutoGenerateColumns = AutoGenerateColumnsMode.AddNew;

wpf-data-grid-create-master-detail-grid-in-code/CS/MasterDetailInCode/MainWindow.xaml.cs#L35

gridDetail.ItemsSourcePath = nameof(Employee.Orders);
gridDetail.DataControl = detailGridControl;

VB.NET

wpf-data-grid-bind-master-and-detail-focused-rows-to-viewmodel-properties/VB/UpdateMasterDetailFocusedRowBehavior.vb#L94

If detailDescriptor IsNot Nothing Then
    tempGrid = CType(detailDescriptor.DataControl, GridControl)
    nestingLevel += 1

wpf-data-grid-display-chart-control-in-grid-details/VB/WpfApplication19/MainWindow.xaml.vb#L48

Dim dataControlDetail As DataControlDetailDescriptor = New DataControlDetailDescriptor()
dataControlDetail.DataControl = SetupDetailGrid()
dataControlDetail.ItemsSourcePath = "Orders"

wpf-data-grid-display-custom-content-in-grid-details/VB/WpfApplication18/MainWindow.xaml.vb#L54

Dim detailGrid As New GridControl()
dataControlDetail.DataControl = detailGrid
detailGrid.AutoGenerateColumns = AutoGenerateColumnsMode.AddNew

wpf-data-grid-create-master-detail-grid-in-code/VB/MasterDetailInCode/MainWindow.xaml.vb#L37

gridDetail.ItemsSourcePath = NameOf(Employee.Orders)
gridDetail.DataControl = detailGridControl
Dim customDetail As ContentDetailDescriptor = New ContentDetailDescriptor()