General Information
.NET Subscription
Desktop
Web
Controls and Extensions
Mainteinance Mode
Enterprise and Analytic Tools
Quality Assurance and Productivity
Frameworks and Libraries
Data Inspector
- 3 min to read
Data Inspector (Web) - Aggregated Data
Data Inspector (Web) - Raw Data
Data Inspector (WinForms) - Aggregated Data
Data Inspector (WinForms) - Raw Data
Data Inspector (WPF) - Aggregated Data
Data Inspector (WPF) - Raw Data
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 
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. |