All docs
V19.2
19.2
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.

Data Inspector

  • 3 min to read

Data Inspector is a dialog window that contains two grids that display raw and aggregated data. The end-user can switch from one grid to another with the radio group located at the window top.

Overview

To invoke the Data Inspector window, click the "Inspect Data" button inspect-data-WinForms in the dashboard item caption or select the "Inspect Data" context menu item.

The "Inspect Data" button and menu item are initially hidden. To show them, set one of the following properties (or both) to true:

Platform Property
WinForms Dashboard Viewer DashboardViewer.AllowInspectAggregatedData
DashboardViewer.AllowInspectRawData
WinForms Dashboard Designer DashboardDesigner.AllowInspectAggregatedData
DashboardDesigner.AllowInspectRawData
WPF Dashboard Control DashboardControl.AllowInspectAggregatedData
DashboardControl.AllowInspectRawData
Web Forms Dashboard Control ASPxDashboard.AllowInspectAggregatedData
ASPxDashboard.AllowInspectRawData
MVC Dashboard Control DashboardExtensionSettings.AllowInspectAggregatedData
DashboardExtensionSettings.AllowInspectRawData
ASP.NET Core Dashboard Control DataInspectorOptionBuilder.AllowInspectAggregatedData
DataInspectorOptionBuilder.AllowInspectRawData
HTML JavaScript Dashboard DataInspectorExtensionOptions.allowInspectAggregatedData
DataInspectorExtensionOptions.allowInspectRawData

When both properties are true, each dashboard item caption contains the "Inspect Data" button. Click the button to invoke the Data Inspector window that contains two grids with raw and aggregated data. The window caption displays the dashboard item caption text.

When only one property is true, the window contains a single grid with raw or aggregated data, depending on what property is switched on. The window caption displays the dashboard item caption text and the inspected item type (raw or aggregated) in parentheses.

Aggregated (Displayed) Data

The data shown as Aggregated is retrieved from the dashboard item's data storage that is the MultiDimensionalData object.

The columns are:

  • Dimensions, except the Sparkline
  • Measures. A list of dimensions does not include unbound measures (the measures without a DataMember, such as Totals and the number of points in a Cluster).
    • The Sparkline is displayed as a column whose values are strings that consist of comma-separated pairs "SparklineArgumentValue - MeasureValue".

A column that contains a byte array byte[] displays a string "[Object]".

Raw Data

Raw data is the dashboard item's underlying data.

API

Call the ShowDataInspector method to invoke the Data Inspector dialog:

Platform Method
WinForms Dashboard Viewer DashboardViewer.ShowDataInspector
WinForms Dashboard Designer DashboardDesigner.ShowDataInspector
WinForms Dashboard Viewer (async) DashboardViewer.ShowDataInspectorAsync
WinForms Dashboard Designer (async) DashboardDesigner.ShowDataInspectorAsync
WPF Dashboard Control DashboardControl.ShowDataInspector
Web Dashboard Control DataInspectorExtension.showDataInspector

To customize the Data Inspector dialog, use the following API:

WinForms

Platform Event
DashboardViewer.DataInspectorFormLoad Occurs before the Data Inspector window displays. Allows you to access the window's grid controls and change their settings.
DashboardViewer.DataInspectorFormClosing Occurs before the Data Inspector window closes. Allows you to access the window's grid controls.
DashboardDesigner.DataInspectorFormLoad Occurs before the Data Inspector window displays. Allows you to access the window's grid controls and change their settings.
DashboardDesigner.DataInspectorFormClosing Occurs before the Data Inspector window closes. Allows you to access the window's grid controls.
DataInspectorFormLoadEventArgs.AllowExportAggregatedData Gets or sets whether end users can export aggregated data from the Data Inspector.
DataInspectorFormLoadEventArgs.AllowExportRawData Gets or sets whether end users can export raw data from the Data Inspector.

WPF

API Description
DataInspectorTemplate Allows you to specify a custom Data Inspector dialog template.
DataInspectorStyle Gets or sets the style applied to the Data Inspector window. This is a dependency property.

Web

API Description
DataInspectorExtensionOptions.onGridContentReady A handler for the event occurring after the Grid widget's content is loaded.
DataInspectorExtensionOptions.onGridInitialized A handler for the event occurring before the Grid widget's content is loaded.
DataInspectorExtensionOptions.onDialogHidden A handler for the event occurring when the Data Inspector dialog is hidden.
DataInspectorExtensionOptions.onDialogHidden A handler for the event occurring before the Data Inspector dialog is shown.
DataInspectorExtensionOptions.onDialogHidden A handler for the event occurring after the Data Inspector dialog is shown.