Upgrading Syncfusion® ASP.NET application to latest version

28 Jan 20253 minutes to read

The Syncfusion® ASP.NET migration add-in for Visual Studio allows you to migrate an existing Syncfusion® ASP.NET 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 Web Application Project Migration utility is available beginning with v13.1.0.30.

To migrate you’re existing Syncfusion® ASP.NET application, follow the steps below.

Before use, the Syncfusion® ASP.NET Web Forms Project Migration, check whether the ASP.NET Web Forms Extensions - Syncfusion® installed or not in Visual Studio Extension Manager by clicking on the Tools -> Extensions and Updates -> Installed for Visual Studio 2017 or lower and for Visual Studio 2019 by clicking on the Extensions -> Manage Extensions -> Installed. 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.

  1. To launch Migration Wizard, select one of the following options:

    Option 1
    Click Syncfusion® Menu and choose Essential Studio® for ASP.NET Web Forms (EJ1) > Migrate Project… in Visual Studio.

    Syncfusion<sup style="font-size:70%">®</sup> Essential<sup style="font-size:70%">®</sup> JS 1 ASP.NET Web Forms Project Migration via Syncfusion<sup style="font-size:70%">®</sup> menu

    NOTE

    From Visual Studio 2019, Syncfusion® menu is available under Extensions in Visual Studio menu.

    Option 2
    Right-click the Syncfusion® ASP.NET Application from Solution Explorer and select Syncfusion® Web (Essential® JS 1). Choose Migrate the Essential® JS 1 Project to Another version…

    Syncfusion<sup style="font-size:70%">®</sup> Essential<sup style="font-size:70%">®</sup> JS 1 ASP.NET Web Forms Project Migration add-in

  2. The Project Migration window appears. You can choose the required Essential Studio® version that is installed in the machine.

    Syncfusion<sup style="font-size:70%">®</sup> Essential<sup style="font-size:70%">®</sup> JS 1 ASP.NET Web Forms Project Migration wizard

  3. The Project Migration window allows you to configure the following options:

    i. Essential Studio® Version: Choose a version from the list of Syncfusion® versions that have been installed.

    ii. Assemblies From: Choose the assembly location, from where the assembly will be added to the project.

    Choose the assembly location, from where the assembly is added to the project

  4. Click the Migrate Button. The Project Backup dialogue box appears. If you select Yes in the dialog, it will backup the current project before migrating the Syncfusion® project. If you select No, the project will be migrated to the required Syncfusion® version without a backup.

    Syncfusion<sup style="font-size:70%">®</sup> Essential<sup style="font-size:70%">®</sup> JS 1 ASP.NET Web Forms Project Migration backup dialog

  5. The Syncfusion® Reference Assemblies, Scripts, and CSS, Web. Config entries in the project are updated to the corresponding version.

  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®.