Upgrading Syncfusion® ASP.NET Core application to latest version

12 Dec 20243 minutes to read

The Syncfusion® ASP.NET Core migration add-in for Visual Studio allows 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.

NOTE

Before use, the Syncfusion® ASP.NET Core Project Migration, check whether the ASP.NET Core Extensions - Syncfusion installed or not in Visual Studio Extension Manager by clicking on the Extensions -> Manage Extensions -> Installed for Visual Studio 2019 or later and for Visual Studio 2017 by clicking on the Tools -> Extensions and Updates -> Installed. If this extension not installed, install the extension by follow the steps from the download and installation help topic. Also, check whether the corresponding Essential Studio® version build installed or not. If the Essential Studio® version is not same for both the Extension and build, then the Project Migration 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 Menu and choose Essential Studio® for ASP.NET Core > Migrate Project… in Visual Studio Menu.

    migrate project

    NOTE

    In Visual Studio 2017, Click Syncfusion Menu 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.

    project migration

    NOTE

    The versions are loaded from the Syncfusion® ASP.NET Core NuGet packages which published in NuGet.org and it requires internet connectivity.

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

    NOTE

    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, scripts, and styles are updated to the selected version in the application.

    If you enabled 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 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 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®.