DashboardBackendOptions Class

Contains options that allow you to configure the Web Dashboard’s back-end.

Namespace: DevExpress.DashboardWeb

Assembly: DevExpress.Dashboard.v20.2.Web.WebForms.dll

NuGet Package: DevExpress.Web.Dashboard

Declaration

C#

public class DashboardBackendOptions

VB.NET

Public Class DashboardBackendOptions

Related API Members

The following members return DashboardBackendOptions objects:

• ASPxDashboard.BackendOptions
• DashboardExtensionSettings.BackendOptions

Remarks

Separated client and server parts require you to configure an ASP.NET Core or ASP.NET MVC Dashboard control as a server and create the client Web Dashboard application.

You can use a Web Dashboard in the following ways:

• Create cross-platform Web Dashboard applications.
• Integrate a Dashboard into anything that supports HTTP requests (e.g., websites, web applications). For example, see the GitHub Pages Demo.
• Publish the Web Dashboard as a part of applications based on Angular, Knockout, Vue and similar frameworks.
• Use the Dashboard with DevExtreme client-side widgets to create responsive web apps.

The table below illustrates correlations between server and client. The column headers display what you can use on a server side, the row headers show available client controls.

Client \ Server	ASP.NET HTTP Handlers	ASP.NET MVC Controller	ASP.NET Core Controller
ASP.NET Web Forms (ASPxDashboard‘s API)[1]
ASP.NET Web Forms (DashboardConfigurator‘s API)
ASP.NET MVC Razor Extension
ASP.NET Core Razor Extension
Dashboard Component for Angular
Dashboard Component for React
Dashboard Component for Vue
Dashboard Control for JavaScript Applications (JQuery, Knockout, etc.)

Use the following properties/methods for a corresponding platform to configure server settings for the client application:

Platform	Member
ASP.NET Web Forms	ASPxDashboard.BackendOptions
ASP.NET MVC	DashboardExtensionSettings.BackendOptions
ASP.NET Core	DashboardBuilder.BackendOptions
HTML JS	DashboardControlOptions.endpoint / AjaxRemoteServiceOptions.headers

The code samples below show how to configure the client: set the server’s url and pass a custom Authorization header. Note that the server’s url should consist of a base URL where the Web Dashboard’s server side is hosted and a route prefix - a value that is set in the MVC / .NET Core MapDashboardRoute properties.

For MVC or ASP.NET Core back-end, the url is a controller’s address:

MVCxDashboard

DashboardControl.BackendOptions.Uri = "{baseURL}/api/dashboard";
DashboardControl.BackendOptions.RequestHttpHeaders.Add("Authorization", "AuthToken123");

ASP.NET Core Dashboard

@(Html.DevExpress().Dashboard("dashboardControl1")
    .BackendOptions(options => options.Uri("{baseURL}/api/dashboard").RequestHttpHeaders(headers => { headers.Add("Authorization", "AuthToken123"); }))
)

HTML JavaScript control

<script>
  window.onload = function () {
    var dashboardControl = new DevExpress.Dashboard.DashboardControl(document.getElementById("web-dashboard"), {
        endpoint: "{baseURL}/api/dashboard",
        ajaxRemoteService: {
            headers: {
                'Authorization': 'AuthToken123'
            }
        }
    });
  }
</script>

For a WebForms control that uses the DashboardConfigurator‘s instance API, provide the Dashboard HTTP handler’s url instead of the controller’s address:

ASPxDashboard

DashboardControl.BackendOptions.Uri = "{baseURL}/api/dashboard/DXDD.axd";

You need to set up cross-origin resource sharing (CORS) on your back-end to configure corresponding permissions to access selected resources from a server at a different origin.

Inheritance

Object

DashboardBackendOptions

Footnotes

1. It is default ASPxDashboard mode. The control uses the ASPxDashboard‘s API for server-side configuration and sends requests only to its own instance.