- 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.
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:
|WinForms Dashboard Viewer||DashboardViewer.AllowInspectAggregatedData
|WinForms Dashboard Designer||DashboardDesigner.AllowInspectAggregatedData
|WPF Dashboard Control||DashboardControl.AllowInspectAggregatedData
|Web Forms Dashboard Control||ASPxDashboard.AllowInspectAggregatedData
|MVC Dashboard Control||DashboardExtensionSettings.AllowInspectAggregatedData
|ASP.NET Core Dashboard Control||DataInspectorOptionBuilder.AllowInspectAggregatedData
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 is the dashboard item's underlying data.
Call the ShowDataInspector method to invoke the Data Inspector dialog:
|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:
|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.|
|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.|
|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.|