Upgrading Syncfusion® ASP.NET Core application to latest version

17 Jul 20263 minutes to read

The Syncfusion® ASP.NET Core migration add-in for Visual Studio allows you to migrate an existing Syncfusion® ASP.NET Core application from one version of Essential Studio® version to another version. This reduces the amount of manual work required when migrating the Syncfusion® version.

IMPORTANT

The Syncfusion® ASP.NET Core (Essential® JS 2) Web Application Project Migration utility is available from v16.3.0.17.

Before using the Syncfusion® ASP.NET Core Project Migration, check whether the ASP.NET Core Extensions - Syncfusion® is installed in the Visual Studio Extension Manager. For Visual Studio 2022 or later, click Extensions -> Manage Extensions -> Installed. If this extension is not installed, please install it by following the steps in the download and installation help topic. Also, check whether the corresponding Essential Studio® version build is installed. If the Essential Studio® version is not the same for both the Extension and the build, the Project Migration option will not be shown.

The steps below will assist you to upgrade the Syncfusion® version in the Syncfusion® ASP.NET Core application via Visual Studio:

  1. Open the Syncfusion® ASP.NET Core application that uses the Syncfusion® component.

  2. To open the Migration Wizard, either one of the following options should be followed:

    Option 1

    Click Extensions > Syncfusion® and choose Essential Studio® for ASP.NET Core > Migrate Project… in Visual Studio Menu.

    migrate project

    Option 2

    Right-click the Syncfusion® ASP.NET Core Application from Solution Explorer and select Syncfusion® Web. Choose Migrate the Syncfusion® ASP.NET Core Project to Another Version…

    migrate syncfuion project

  3. The Syncfusion® Project Migration window will appear. You can choose the required version of Syncfusion® ASP.NET Core to migrate. The list contains all Syncfusion® ASP.NET Core versions published on NuGet.org.

    project migration

    The versions are loaded from the Syncfusion® ASP.NET Core NuGet packages which are published on NuGet.org, and an active internet connection is required.

    Assets From: Load the Syncfusion® Essential® JS 2 assets to ASP.NET Core Project, from either NPM, CDN or Installed Location.

    Installed location option will be available only when the Syncfusion® Essential® JavaScript 2 setup has been installed.

  4. Check the “Enable a backup before migrating” checkbox if you want to take the project backup and choose location.

  5. The Syncfusion® Reference Assemblies, NuGet packages, Scripts, and CSS are updated to the corresponding version in the project. The specific changes include:

    • The Syncfusion.EJ2.AspNet.Core NuGet package is upgraded to the selected version.
    • The ej2.min.css and ej2.min.js script and style references in _Layout.cshtml are updated.
    • Any Syncfusion® configuration files (such as SyncfusionLicensing) are updated to the new version.

    If you enabled the project backup before migrating, the old project was saved in the specified backup path location, as shown below once the migration process is completed.

    BackupLocation

  6. If you have installed the trial setup or NuGet packages from nuget.org, you must register the Syncfusion® license key to your project since Syncfusion® introduced the licensing system from the 2018 Volume 2 (v16.2.0.41) Essential Studio® release. Navigate to the help topic to generate and register the Syncfusion® license key to your project. Refer to this blog post for understanding the licensing changes introduced in Essential Studio®.