.NET Core 3.0+ Support in XAF WinForms Applications

• Dec 13, 2021
• 3 minutes to read

Prerequisites

Ensure that the following components are installed on your machine:

Component	.NET Core 3.0	.NET Core 3.1
DevExpress .NET Components or NuGet packages	v19.2.3+	v19.2.5+
.NET Core SDK and runtime	3.0	3.1
Visual Studio 2019	v16.3+	v16.4+

NuGet Packages

The DevExpress .NET Core Desktop 20.2 Local package source and DevExpress NuGet Gallery include the following XAF-specific packages.

General Packages

• DevExpress.WindowsDesktop.XAF
• DevExpress.WindowsDesktop.XAF.ExpressApp
• DevExpress.WindowsDesktop.XAF.ExpressApp.Win
• DevExpress.WindowsDesktop.XAF.Persistent.Base
• DevExpress.WindowsDesktop.XAF.Persistent.BaseImpl
• DevExpress.WindowsDesktop.XAF.Persistent.BaseImpl.EFCore
• DevExpress.WindowsDesktop.XAF.Persistent.BaseImpl.EFCore.Legacy

ORM-Oriented Packages

• DevExpress.WindowsDesktop.XAF.EF
• DevExpress.WindowsDesktop.XAF.EFCore
• DevExpress.WindowsDesktop.XAF.Xpo

Extra Module Packages

• DevExpress.WindowsDesktop.XAF.AuditTrail
• DevExpress.WindowsDesktop.XAF.Chart
• DevExpress.WindowsDesktop.XAF.Chart.Win
• DevExpress.WindowsDesktop.XAF.CloneObject
• DevExpress.WindowsDesktop.XAF.ConditionalAppearance
• DevExpress.WindowsDesktop.XAF.Dashboards
• DevExpress.WindowsDesktop.XAF.Dashboards.Win
• DevExpress.WindowsDesktop.XAF.FileAttachment.Win
• DevExpress.WindowsDesktop.XAF.Kpi
• DevExpress.WindowsDesktop.XAF.Notifications
• DevExpress.WindowsDesktop.XAF.Notifications.Win
• DevExpress.WindowsDesktop.XAF.Objects
• DevExpress.WindowsDesktop.XAF.Office
• DevExpress.WindowsDesktop.XAF.Office.Win
• DevExpress.WindowsDesktop.XAF.PivotChart
• DevExpress.WindowsDesktop.XAF.PivotChart.Win
• DevExpress.WindowsDesktop.XAF.PivotGrid
• DevExpress.WindowsDesktop.XAF.PivotGrid.Win
• DevExpress.WindowsDesktop.XAF.ReportsV2
• DevExpress.WindowsDesktop.XAF.ReportsV2.Win
• DevExpress.WindowsDesktop.XAF.Scheduler.Win
• DevExpress.WindowsDesktop.XAF.ScriptRecorder
• DevExpress.WindowsDesktop.XAF.ScriptRecorder.Win
• DevExpress.WindowsDesktop.XAF.Security
• DevExpress.WindowsDesktop.XAF.Security.Xpo
• DevExpress.WindowsDesktop.XAF.StateMachine
• DevExpress.WindowsDesktop.XAF.TreeListEditors
• DevExpress.WindowsDesktop.XAF.TreeListEditors.Win
• DevExpress.WindowsDesktop.XAF.Validation
• DevExpress.WindowsDesktop.XAF.Validation.Win
• DevExpress.WindowsDesktop.XAF.ViewVariantsModule

EasyTest Packages

• DevExpress.WindowsDesktop.XAF.EasyTest
• DevExpress.WindowsDesktop.XAF.EasyTest.WinAdapter

Unsupported Modules

The following modules will not be supported due to .NET Core platform limitations or due to deprecated status:

• All ASP.NET WebForms modules:

  • DevExpress.ExpressApp.*Web.v20.2.dll
  • DevExpress.ExpressApp.DataService.v20.2.dll

• DevExpress.ExpressApp.HtmlPropertyEditor.*v20.2.dll

• DevExpress.ExpressApp.Workflow.*v20.2.dll

Important Notes

1. The following design-time functionality is not available because of the changes to Visual Studio’s designer architecture in .NET Core: Module and Application Designers, Controller & Action designers, EasyTest debugging commands. You can perform related tasks in code:
   • Add a Module in Code | Add a Business Class from an Assembly in Code
   • Add a Controller in Code | Add an Action to a Controller
   • Add an Auxiliary .NET Framework Project to Design a Report, Dashboard, User Controls or Forms
   • Run Functional Tests with the Command-Line TestExecutor Utility
2. The Template Gallery and its templates are unavailable. To add an XAF Business Object or Controller, invoke the Add New Item… dialog for your project, navigate to the DevExpress | XAF category, and choose an item.
3. If you use EasyTest, use the AdapterFileName keyword instead of AdapterAssemblyName to specify the path to the WinForms EasyTest adapter. To use the standard adapter, specify the following path: %PROGRAMFILES(x86)%\DevExpress 20.2\.NET Core Desktop Libraries\Bin\NetCore\DevExpress.ExpressApp.EasyTest.WinAdapter.v20.2.dll.
4. The DBUpdater and Model Editor tools do not support 64-bit applications.
5. When you use the DBUpdater tool to update a database, pass the …\MySolution.Win\bin\Debug\netcoreapp3.1\MySolution.Win.dll.config file as the tool’s parameter.
6. When you localize an XAF application, add a DevExpress.WindowsDesktop.XAF.**  NuGet package for German, Spanish, Japanese, or Russian or add downloaded satellite assemblies to the application’s bin folder.
7. The Security System does not support a .NET Core WCF server due to .NET Core platform limitations. You can connect a .NET Core client application to a .NET Framework WCF server only.
8. The outdated Security System based on IPermission, ISecuritySimple, etc. is not supported.