Skip to main content
All docs
V22.1

Frequently Asked Questions - Blazor UI (FAQ)

  • 6 minutes to read

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 of 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 Standard 2.0 or .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 22.1\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: ((BlazorApplication)yourXafApplicationInstance).ServiceProvider. For more information, see Dependency Injection.

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

Deployment

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

A: Yes, absolutely. For more information, refer to the following articles: Host and deploy ASP.NET Core Blazor Server | Deployment Recommendations for XAF Blazor UI Applications.

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:

Customize Pop-Up Dialogs

Q: How do I resize popup dialogs? Can I increase the default window width if it contains a complex form?

A: How to: Adjust the Size and Style of Pop-up Dialogs (Blazor).

“Save & New” and “Save & Close” Buttons

Q: How do I return the “Save & New” and “Save & Close” buttons in DetailView (as it was in WinForms and WebForms)?

A: Blazor - How to implement the “Save & New” and “Save & Close” buttons.

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: https://docs.microsoft.com/en-us/aspnet/core/blazor/supported-platforms (Microsoft Internet Explorer 11 and older versions are not supported).

We test 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).

VB.NET Support

Q: Can I create a VB.NET Blazor UI application?

A: You can attach your VB.NET modules converted to .NET Standard 2.0 to a C# Blazor application.

XAF does not ship a VB.NET project template for the Blazor UI. You cannot create a VB.NET Blazor application because Microsoft does not support this functionality: Support VB.NET in ASP.NET Core 3.0 and Blazor.