Skip to main content
All docs

Frequently Asked Questions - Blazor UI (FAQ)

  • 8 minutes to read

Differences between XAF Blazor UI and XAF WinForms/WebForms UI

Q: Why do XAF Blazor UI apps implement different behavior/options?

A: ASP.NET Core Blazor, .NET WinForms, and ASP.NET Web Forms are three distinct Microsoft technologies/frameworks, with release dates about 20 years apart. Platform architecture is naturally very different: the view on application development and security has evolved, as did usage scenarios and developer requirements. And you may not be sure, given the platform choice, if you should go with a “proven and tested” versus “most modern” technology.

Even though Blazor is the youngest of the three, we believe it is ready for most line-of-business applications. We recommend that you use XAF Blazor UI for new applications. You can also transfer existing apps.

XAF Blazor UI offers you numerous unique benefits over Web Forms such as:

If you migrate your applications, keep in mind that not all solutions applicable to WinForms or Web Forms are suitable for Blazor. Our approach towards Blazor development does not mean identical replication of behavior from our Web Forms or WinForms modules and features. You may need to adjust your applications if you transition to Blazor.

If you find reasons against transition, you can continue using ASP.NET Web Forms or WinForms UI. In such cases, please let us know why you chose not to migrate. Reach out to us via our Support Center and tell us about your use cases and requirements. Your feedback and insights are incredibly valuable in shaping our offerings to best meet your needs.

Reuse Existing .NET Framework Code

Q: I want to create a Blazor UI application based on an existing XAF .NET Framework application. How do I proceed?

A: You can re-use most ORM data models and platform-agnostic controllers in Blazor UI with minimal or no changes. The basic CRUD and data view XAF APIs are platform-agnostic, for example, IObjectSpace, ViewController, View, or Frame.

You can add existing platform-independent modules to an XAF Blazor UI project. Convert required modules to .NET 6: .NET 6+ Support and Migration from .NET Framework. Once conversion is complete, refer to the following article for further instructions: (Add a Module in Code).

All platform-dependent code should be rewritten. Blazor applications have a different architecture and life cycle; the code that was common for ASP.NET Web Forms and Windows Forms may need to be changed for Blazor. Refer to the following article for more information: An introduction to Blazor for ASP.NET Web Forms developers.

Add a Custom XAF Module

Q: How do I add a new custom XAF module into an existing Blazor solution?

A: Use the Add DevExpress Item | New Project menu to add a new custom XAF module to an existing XAF .NET 6+ app.

Integrate Custom UI Components

Q: How do I use components that are not integrated in the Blazor UI by default?

A: Review the list of DevExpress Blazor and JavaScript (DevExtreme) UI components and the following XAF integration articles:

You can review how we implement List and Property Editors. This may help you integrate custom components. See the files in the following folder: %PROGRAMFILES%\DevExpress 23.2\Components\Sources\DevExpress.ExpressApp\DevExpress.ExpressApp.Blazor\Editors\.

Access ASP.NET Core DI Services via IServiceProvider

Q: How do I access services from a built-in ASP.NET Core service container (IServiceProvider)?

A: To access BlazorApplication.IServiceProvider, use the following code: XafApplication.ServiceProvider. For more information, see the following topic: Dependency Injection (DI).

You may find the following examples helpful:

Using GPS and Camera on Mobile Devices

Q: Can I upload photos from a mobile device camera in XAF Blazor apps?

A: Yes. Evolved web development standards and modern browsers made it possible to accomplish many hardware-related tasks (GPS, camera, etc.) in such applications. See also: How to implement a QR / barcode scanner using a camera of a mobile device.

XAF Blazor Server Mobile Upload Files


Q: Can I deploy XAF Blazor apps to Cloud platforms (Azure, AWS, etc.), Linux (with Nginx or Apache), Windows (with IIS), Docker, and Kubernetes?

A: Yes, absolutely. For more information, refer to the following articles:

High Load and Scaling

Q: Is Blazor UI appropriate for applications with thousands of concurrent users?

A: We cannot recommend XAF’s Blazor UI for high-load applications that should serve hundreds or thousands of concurrent web clients on a single web server. Refer to the following article for details: Deployment Recommendations for XAF Blazor UI Applications.

Offline Mode Support

Q: Does XAF Blazor UI support offline mode?

A: No. The current Blazor Server platform requires a permanent connection to a server.

Supported Identity Providers

Q: Does XAF’s Blazor UI support OAuth2 (Azure AD, Microsoft 365, Google Firebase, etc.) or JWT authentication (Identity Server, Auth0, etc.)?

A: Yes, XAF supports these identity providers with the help of built-in ASP.NET Core capabilities and XAF’s security system extensibility. You may find the following examples helpful:

Supported Browsers

Q: What are the supported desktop and mobile web browsers?

A: You can find the supported browser list in the following Microsoft article: (Microsoft Internet Explorer 11 and older versions are not supported).

We test the XAF Blazor UI in the following environments:

  • The latest desktop Google Chrome and Mozilla FireFox versions (automated tests and screenshot-based tests with EasyTest and Selenium).
  • The latest versions of Google Chrome on Android, Safari (including iOS), and Microsoft Edge (manual testing).

Keep Connection Alive

The XAF Blazor UI is a regular ASP.NET Core Blazor Server application that uses SignalR to keep a connection to the server alive. Use the following solution to manage this behavior: Timeout and keepalive settings.

Blazor WebAssembly

Q: Does XAF Blazor UI support WebAssembly?

A: XAF Blazor UI generates an application based on the Blazor Server hosting model. You can also build a custom Blazor WebAssembly app and reuse parts of your XAF project: data model, select modules (such as Security, Reporting, File Attachments), and custom logic. Use our backend Web API Service for this purpose. Review the corresponding GitHub Example & Tutorial for more information.