All docs
V20.2
20.2
20.1
The page you are viewing does not exist in version 20.1. This link will take you to the root page.
19.2
The page you are viewing does not exist in version 19.2. This link will take you to the root page.
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.

Create a WinForms Dashboard Viewer (.NET)

  • 2 minutes to read

This tutorial describes how to create a WinForms application with the Dashboard Viewer in .NET 5 (and .NET Core 3.1).

Prerequisites

Create a New Project

You can create a new .NET project in the console window or use Visual Studio's template.

Create a New .NET Project in the Console Window

Open the console window and follow the steps below:

  1. Create and open a new folder. The folder name is the project name.

    mkdir NewCoreApp
    cd NewCoreApp
    
  2. Create a WinForms project:

    dotnet new winforms
    
  3. Create a solution file:

    dotnet new sln
    
  4. Add the created .NET project to this solution:

    dotnet sln add NewCoreApp.csproj
    

Open the created solution in Visual Studio.

Create a New .NET Project in Visual Studio

  1. In Visual Studio, create a new project and select Windows Forms App (.NET) on the start page as the project template.

    NOTE

    Do not select the Windows Forms App (.NET Framework) template.

Install Dashboard packages

  1. Select Manage NuGet Packages in the invoked context menu to invoke the NuGet Package Manager.

    manage-nuget-packages

  2. Register the DevExpress NuGet feed as a package source and select it in the drop-down menu.

  3. Install the DevExpress.WindowsDesktop.Win.Dashboard package.

    install-nuget-package

The installed libraries are added to the project after installation is completed.

Create a WinForms Dashboard Viewer

To create the Dashboard Viewer at runtime, add the following code in a Form1.cs file:

using System.Windows.Forms;
using DevExpress.DashboardWin;

//...

DashboardViewer viewer = new DashboardViewer();
this.Controls.Add(viewer);
viewer.Dock = DockStyle.Fill;

Use the DashboardDesigner.LoadDashboard method to load an existing dashboard in code.

Next Steps