DashboardController Class

Namespace: DevExpress.DashboardWeb.Mvc

Assembly: DevExpress.Dashboard.v21.2.Web.Mvc5.dll

Declaration

public abstract class DashboardController :
    RestrictedDashboardController

Public MustInherit Class DashboardController
    Inherits RestrictedDashboardController

Remarks

You can verify the trust level and specify which actions a client can initiate to execute them on a server side. If you use Restricted mode, you can prevent inadvertent or unauthorized modifications to dashboards stored on the server. A list below describes the Web Dashboard’s specifics when it operates in the Restricted mode:

• Only dashboards stored in dashboard storage can be processed on the client. The designer mode does not work.

• Calling the IEditableDashboardStorage.AddDashboard and IDashboardStorage.SaveDashboard methods leads to an exception.

• Information about data sources contained in a dashboard xml definition is not passed to the client when you request a dashboard xml file.

You can do one of the following to prevent inadvertent or unauthorized dashboard modifications and protect dashboards stored on a server:

• Handle the DashboardConfigurator.VerifyClientTrustLevel event and set e.ClientTrustLevel to Restricted mode.
• Derive a custom dashboard controller from RestrictedDashboardController instead of DashboardController.

See the following example for information on how to create and use a restricted dashboard controller in an ASP.NET MVC app:

View Example: How to create a restricted dashboard controller

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DashboardController class.

namespace MvcThrowCustomExceptionDashboardErrorToast.Controllers {
    public class CustomDashboardController : DashboardController {
        protected override void OnException(ExceptionContext context) {

namespace MvcCustomController {
    public class DefaultDashboardController : DashboardController {
    }

var controller = base.CreateController(requestContext, controllerName);
if (controller.GetType() == typeof(DevExpress.DashboardWeb.Mvc.DashboardController)) {
    throw new HttpException(404, string.Format("The controller '{0}' was not found", controllerName));

{
    public class DefaultDashboardController : DashboardController
    {

namespace DashboardLocalizationHTMLJS.Controllers {
    public class DefaultDashboardController : DashboardController {

Public Class CustomDashboardController
    Inherits DashboardController
    Protected Overrides Sub OnException(ByVal context As ExceptionContext)

Public Class DefaultDashboardController
    Inherits DashboardController

Public Class DefaultDashboardController
    Inherits DashboardController

Public Class DefaultDashboardController
    Inherits DashboardController

Public Class DefaultDashboardController
    Inherits DashboardController