XafApplication.CreateController<ControllerType>() Method

Creates a Controller of a specified type. If there is a Controller of the same type, assigns its settings to the new Controller.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public virtual ControllerType CreateController<ControllerType>()
    where ControllerType : Controller, new()

VB.NET

Public Overridable Function CreateController(Of ControllerType As {Controller, New}) As ControllerType

Type Parameters

Name
ControllerType

Returns

Type	Description
ControllerType	A Controller of the specified type.

Remarks

When you implement a PopupWindowShowAction, you may need to provide a custom Dialog Controller for the Action’s pop-up Window. Use the CreateController<ControllerType> method to create this custom Dialog Controller:

C#

private void MyPopupWindowShowAction_OnCustomizePopupWindowParams(Object sender,
      CustomizePopupWindowParamsEventArgs e) {
   //...
   e.DialogController = Application.CreateController<MyDialogController>();
}

VB.NET

Private Sub MyPopupWindowShowAction_OnCustomizePopupWindowParams(ByVal sender As Object, _
      ByVal e As CustomizePopupWindowParamsEventArgs)
   '...
   e.DialogController = Application.CreateController(Of MyDialogController)()
End Sub

This method creates a Controller of the specified type. If a Controller of the same type already exists, the Controller.Actions of the found Controller serve as a source for the ActionBase.Model property of the new Controller’s Actions.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CreateController<ControllerType>() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

XAF_how-to-show-filter-dialog-before-listview/CS/E1554.Module/ShowFilterDialogController.cs#L42

e.ActionArguments.ShowViewParameters.TargetWindow = TargetWindow.NewModalWindow;
DialogController dialogCotnroller = Application.CreateController<DialogController>();
dialogCotnroller.Accepting += new EventHandler<DialogControllerAcceptingEventArgs>(dialogCotnroller_Accepting);

xaf-web-forms-use-oauth2-authentication-providers/CS/MySolution.Module.Web/WebModule.cs#L45

    XafApplication app = (XafApplication)sender;
    e.Controllers.Add(app.CreateController<LogonAuthController>());
}

VB.NET

XAF_how-to-show-filter-dialog-before-listview/VB/E1554.Module/ShowFilterDialogController.vb#L43

e.ActionArguments.ShowViewParameters.TargetWindow = TargetWindow.NewModalWindow
Dim dialogCotnroller As DialogController = Application.CreateController(Of DialogController)()
AddHandler dialogCotnroller.Accepting, AddressOf dialogCotnroller_Accepting

xaf-web-forms-use-oauth2-authentication-providers/VB/MySolution.Module.Web/WebModule.vb#L47

    Dim app As XafApplication = DirectCast(sender, XafApplication)
    e.Controllers.Add(app.CreateController(Of LogonAuthController)())
End Sub