Upgrading to Radzen.Blazor v5.0

Hi all.

You may experience visual issues while upgrading your app to Radzen.Blazor 5.0. Those happen because the browser loads a cached (thus old) version of the theme CSS file. Clear your browser cache If you are using a free theme. This will force loading the latest CSS file. If you are using a premium theme you have to reapply the theme in Radzen Blazor Studio in order to update it: simply change to any other theme and then back to the one you were using.

The new RadzenAppearanceToggle requires RadzenTheme to be used as well (which is also a new component). To use RadzenTheme in an existing application check the getting started instructions. Then delete the existing Radzen Blazor theme e.g. <link rel="stylesheet" href="_content/Radzen.Blazor/css/material-base.css" /> as RadzenTheme includes it already. Also make sure to place RadzenTheme before your applications local CSS file (app.css or site.css). Using RadzenTheme has the added benefit of solving CSS caching problems.

OLD (.NET 8 App.razor, server rendering mode):

<link rel="stylesheet" href="_content/Radzen.Blazor/css/material-base.css" />
<link href="css/site.css" rel="stylesheet" />

NEW:

<RadzenTheme @rendermode="InteractiveServer" Theme="material" />
<link href="css/site.css" rel="stylesheet" />

To persist the current theme per user you can use the CookieThemeService.

Important: If you have upgraded your application to .NET 8 or .NET 9 follow the getting started instructions for the version you initially used - e.g. .NET 7 or .NET 6.

Our .NET 8 and 9 instructions assume the new application layout which uses rendering modes and was introduced with .NET 8.

Bootstrap: Radzen.Blazor no longer ships a copy of Bootstrap in the CSS files. If you have an application created with Radzen Studio you should manually include the Bootstrap CSS before upgrading to Radzen.Blazor 5.0:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.3.1/dist/css/bootstrap.min.css" >