dashboard-devexpress-dot-dashboardcommon-8b160919.md
Represents a list of records from the dashboard data source.
Namespace : DevExpress.DashboardCommon
Assembly : DevExpress.Dashboard.v25.2.Core.dll
NuGet Package : DevExpress.Dashboard.Core
public class DashboardUnderlyingDataSet :
DashboardDataSet<DashboardUnderlyingDataRow>
Public Class DashboardUnderlyingDataSet
Inherits DashboardDataSet(Of DashboardUnderlyingDataRow)
The following members return DashboardUnderlyingDataSet objects:
Show 34 links
A DashboardUnderlyingDataSet object is returned by the DashboardDesigner.GetUnderlyingData and DashboardViewer.GetUnderlyingData methods. Any of these methods allow you to obtain a list of records from the dashboard data source.
You can also obtain the underlying data for specific visual elements when handling DashboardViewer events, for instance, the DashboardViewer.DashboardItemClick event. Use the DashboardItemMouseHitTestEventArgs.GetUnderlyingData method to do this.
Individual rows in the DashboardUnderlyingDataSet are represented by DashboardUnderlyingDataRow objects.
This example demonstrates how to display the underlying data when an end-user double-clicks a dashboard item.
Handle the DashboardItem.DoubleClick event. Call the e.GetUnderlyingData method to retrieve records from the dashboard item’s data source. Invoke a form with the Grid control that displays the data.
Note
Starting with v19.2, you can use the built-in Data Inspector to display the underlying data.
using DevExpress.DashboardCommon;
using DevExpress.DashboardWin;
using DevExpress.Utils;
using DevExpress.XtraEditors;
using System.Windows.Forms;
namespace Dashboard_UnderlyingDataWin {
public partial class Form1 : XtraForm {
public Form1() {
InitializeComponent();
}
private void dashboardViewer1_DashboardItemDoubleClick(object sender, DashboardItemMouseActionEventArgs e) {
XtraForm form = new XtraForm {
Text = "Underlying Data"
};
DashboardUnderlyingDataSet underlyingData = e.GetUnderlyingData();
if (underlyingData != null && underlyingData.RowCount > 0) {
DevExpress.XtraGrid.GridControl grid = new DevExpress.XtraGrid.GridControl {
Parent = form,
Dock = DockStyle.Fill,
DataSource = underlyingData,
};
}
else {
LabelControl lbl = new LabelControl {
Text = "No Data",
Parent = form,
};
lbl.AutoSizeMode = LabelAutoSizeMode.None;
lbl.Appearance.TextOptions.HAlignment = HorzAlignment.Center;
lbl.Appearance.TextOptions.VAlignment = VertAlignment.Center;
lbl.Dock = DockStyle.Fill;
}
form.ShowDialog();
form.Dispose();
}
}
}
Imports DevExpress.DashboardCommon
Imports DevExpress.DashboardWin
Imports DevExpress.Utils
Imports DevExpress.XtraEditors
Imports System.Windows.Forms
Namespace Dashboard_UnderlyingDataWin
Partial Public Class Form1
Inherits XtraForm
Public Sub New()
InitializeComponent()
End Sub
Private Sub dashboardViewer1_DashboardItemDoubleClick(ByVal sender As Object, ByVal e As DashboardItemMouseActionEventArgs) Handles dashboardViewer1.DashboardItemDoubleClick
Dim form As XtraForm = New XtraForm With {.Text = "Underlying Data"}
Dim underlyingData As DashboardUnderlyingDataSet = e.GetUnderlyingData()
If underlyingData IsNot Nothing AndAlso underlyingData.RowCount > 0 Then
Dim grid As DevExpress.XtraGrid.GridControl = New DevExpress.XtraGrid.GridControl With {.Parent = form, .Dock = DockStyle.Fill, .DataSource = underlyingData}
Else
Dim lbl As LabelControl = New LabelControl With {.Text = "No Data", .Parent = form}
lbl.AutoSizeMode = LabelAutoSizeMode.None
lbl.Appearance.TextOptions.HAlignment = HorzAlignment.Center
lbl.Appearance.TextOptions.VAlignment = VertAlignment.Center
lbl.Dock = DockStyle.Fill
End If
form.ShowDialog()
form.Dispose()
End Sub
End Class
End Namespace
Object DevExpress.DashboardCommon.Native.DashboardDataSet<DashboardUnderlyingDataRow> DashboardUnderlyingDataSet
See Also