Skip to main content
All docs
V24.1

Manage Data Inspector in the WinForms Viewer

  • 3 minutes to read

Data Inspector is a dialog window that displays raw or aggregated data. The window can contain one or two grids depending on chosen options. A user can employ the radio group located at the window top to switch between grids.

Data Inspector (WinForms) - Aggregated Data

Aggregated and Raw Data

Aggregated Data
Aggregated Data is retrieved from the dashboard item’s data storage that is the MultiDimensionalData object. For more information on how Aggregated Data is displayed in Data Inspector, refer to the following article: Aggregated Data.
Raw Data
Raw data is the dashboard item’s underlying data. For more information on how Aggregated Data is displayed in Data Inspector, refer to the following article: Raw Data.

For more information on underlying and displayed data in the WinForms Viewer, refer to the following article: Underlying and Displayed Data.

Enable Data Inspector

The Inspect Data button and the corresponding menu item are initially hidden. To show them, set one of the following properties to true depending on the data you want to display:

//...
public Form1() {
    InitializeComponent();
    dashboardViewer1.AllowInspectAggregatedData = true;
    dashboardViewer1.AllowInspectRawData = true;
}

To invoke the Data Inspector window in the UI, click the Inspect Data button in the dashboard item caption or select the Inspect Data context menu item:

Winforms Viewer - Invoke Data Inspector

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

When both properties are set to true, the window contains two grids with raw and aggregated data and allows a user to switch between them. The window caption displays the dashboard item caption text.

WinForms - Data Inspector Window

Data Inspector can display hidden measures and does not display hidden dimensions. You can add data members to the Hidden Measures section to display them only in the Data inspector and keep visual data unchanged.

Customize Data Inspector

Call the ShowDataInspector method to invoke the Data Inspector dialog:

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.
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.

Export Data

Data Inspector allows you to export data in different formats.

Use the Print Preview dialog to export data in the desired format (Excel, PDF, Image, etc.)

WinForms Dashboard - Print Preview Dialog in Data Inspector