Syncfusion® Project Conversion

18 Nov 20183 minutes to read

Syncfusion® ASP.NET Core conversion is a Visual Studio add-in that converts an existing ASP.NET Core application into a Syncfusion® ASP.NET Core (Essential® JS 2) Web application by adding the required assemblies and resource files.

The Syncfusion® ASP.NET Core (Essential® JS 2) Web Application Project conversion utility is available from v16.3.0.17. Before using the Syncfusion® ASP.NET Core Project Conversion, check whether the ASP.NET Core Extensions - Syncfusion® is installed or not in Visual Studio Extension Manager by clicking Extensions > Manage Extensions > Installed for Visual Studio 2022 or later. If this extension is not installed, please install the extension by following the steps from the download and installation help topic. Also, check whether the corresponding Essential Studio® version build is installed or not. If the Essential Studio® version is not the same for both the Extension and build, then the Project Conversion will not be shown.

The steps below help you to convert the ASP.NET Core application to the Syncfusion® ASP.NET Core application via the Visual Studio:

  1. Open an existing Microsoft ASP.NET Core Web Application or create a new Microsoft ASP.NET Core Web Application.

  2. To open the Syncfusion® Project Conversion Wizard, follow either one of the options below:

    Option 1:

    Click Extensions > Syncfusion® and choose Essential Studio® for ASP.NET Core > Convert to Syncfusion® ASP.NET Core Application… in Visual Studio Menu.

    convert project

    Option 2:

    Right-click the Project from Solution Explorer, select Syncfusion® Web, and choose the Convert to Syncfusion® ASP.NET Core Application…

    convert to syncfusion

  3. The Syncfusion® ASP.NET Core Project Conversion window will appear. You can choose the required version of Syncfusion® ASP.NET Core, Assets from, and Themes to convert the application.

    project conversion wizard

    The following configurations are used in the Project conversion wizard.

    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.

    Starting from version 34.1.x, Syncfusion provides support through individual NuGet packages instead of the Syncfusion.EJ2.AspNet.Core common package. When converting a project to 34.1.x or later, the required individual NuGet packages for the selected components will be added instead of common package.

    Choose the Theme: Choose the required theme.

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

  5. The required Syncfusion® NuGet packages, Scripts and CSS are included in the ASP.NET Core Web application. Refer to the following screenshots for more information.

    dependencies

    project structure

    css-reference

    If you enabled project backup before converting, the old project is saved in the specified backup path location, as shown below once the conversion 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 application 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®.