How to Upgrade the Project into a New Syncfusion® Version?

28 Jan 20252 minutes to read

Upgrade the Project Using Project Migration Tool

Syncfusion® provides project migration tool for the platforms listed below.

Platform Guidelines for migrating the projects to latest Syncfusion® version
Blazor Blazor Migration using Visual Studio
Blazor Migration using Visual Studio Code
ASP.NET Core (Essential® JS 2) ASP.NET Core - JS 2 Migration
ASP.NET MVC (Essential® JS 2) ASP.NET MVC - JS 2 Migration
Windows Forms Windows Forms Migration
WPF WPF Migration
Universal Windows Universal Windows Migration

Upgrading the Projects Manually

You can upgrade the project in two methods, based on the procedure used in your project, to reference the Syncfusion® assemblies. They are:

CopyLocal=True

  1. Set the SpecificVersion to False.
  2. Remove the bin and obj folders in your local project directory.
  3. Replace the latest assemblies with the upgraded assemblies in the local folder of your project.
  4. Recompile the project.

CopyLocal=False

  1. Ensure that the old Syncfusion® assemblies are removed from GAC.
    • For 2.0 and 3.5 assemblies: (C:\windows\assembly)
    • For 4.0, 4.5, and 4.5.1 assemblies: (C:\Windows\Microsoft.NET\assembly\GAC_MSIL)
  2. Install the latest Syncfusion® assemblies on your machine using the Syncfusion® Assembly Manager.
  3. Set the SpecificVersion to False.

  4. Recompile your project; the latest assemblies from GAC refer to your project automatically.

    Manual Upgradation

NOTE

This method is only applicable to the platforms listed below, for which the Syncfusion® assemblies will be installed in GAC.

  • WPF
  • Windows Forms

Switching the Framework Version While Upgrading the Project

When you want to switch the Framework version while upgrading the project, use the Multi-Target Manager from the Syncfusion® Dashboard.

After switching the Framework version using Multi-Target Manager, remove the bin and obj folders from your local project directory, and then recompile your project.

For more details about Multi-Target Manager, refer to Multi-Target Manager.

Migrating the Resource Files

Follow the given steps to move the resource files (.resx) of your project to the newer version:

  1. Open Start > Syncfusion® > Essential® Studio x.x.x.x > Utilities > Migration > ConvertResx(Framework 2.0,3.5 or 4.0).
  2. Click the Choose ResX Files to convert.
  3. Select the Resx files you want to convert.
  4. Click Start Converting Files.
  5. After the conversion, the new Resx files should have the same name as the original files. Copies of the original files have the old suffix added to their names.