How to upgrade Syncfusion® Blazor Components to the latest version

29 Nov 20242 minutes to read

To upgrade Syncfusion® Blazor Components to the latest version, you need to ensure the following:

Compatible .NET version

Syncfusion® Blazor components in the latest version '{:nuget-version:}' are compatible with the latest version of .NET 8.0 or .NET 9.0. Also, refer to version compatibility documentation for more information about version compatibility of Syncfusion® Blazor components and .NET Core SDK.

Client resource file references

Ensure your CSS files have been properly configured in your application.

  • Add the following style file reference in the ~/Components/App.razor for Blazor Web app or add it in the ~/Pages/_Host.cshtml for Blazor Server app or add it in the ~/wwwroot/index.html for Blazor WebAssembly app.

    If you are using Syncfusion.Blazor NuGet package in your application, then use the below reference link.

      <link href="_content/Syncfusion.Blazor/styles/bootstrap4.css" rel="stylesheet" />

    If you are using individual NuGet packages in your application, then use the below reference link.

      <link href="_content/Syncfusion.Blazor.Themes/bootstrap4.css" rel="stylesheet" />

NOTE

For production purpose and minimal requirement, Syncfusion® provides an option to generate custom styles of selective components by using the ThemeStudio web application. Refer to this link for more details on ThemeStudio.

Breaking changes

Some changes have been modified in our Blazor samples for each release. So, we suggest you to ensure the breaking changes. Refer to this release notes for our Blazor components.

Cache problem

Before restoring the NuGet packages, clean the older versions of Syncfusion® Blazor NuGet packages.

The following steps explain how to clean the cache:

  1. Delete the Syncfusion® Blazor NuGet packages from the installed location {System-driver}/Users/{user-name}/.nuget/packages/. In Windows, the installed location of Syncfusion® Blazor NuGet packages can be found using %userprofile%/.nuget/packages/.

  2. Update the latest version of Syncfusion® Blazor NuGet packages.

Linker.xml configuration

In Blazor WebAssembly application, ensure if you have configured Linker.xml file in your Syncfusion® Blazor application. Missing this configuration may prevent the rendering of Syncfusion® Blazor components in the application.

Refer to this KB article for more information on Linker.xml file usage.

NOTE

Linker.xml configuration is applicable only for the Blazor WebAssembly application.

See Also