Edit this page

Convert Project

The Project management functionality of the Visual Studio Extensions handles project assembly reference updates, web.config entry management and updates of the supporting resources.

This functionality is handled by three wizards - the Project Convert Wizard, Project Configuration Wizard and Upgrade Wizard.

Telerik Convert Project wizard could be accessed through the Telerik > Telerik® UI for ASP.NET Ajax menu:

introduction-vsx convertwizard menu

The Convert Project Wizard’s first page lets you define settings related to Telerik controls:

introduction-vsx convertwizard versions

  • Version - Select the Telerik controls version which to be used in your project. The product versions which could be selected are detected from an installation folder (marked with [InstallFolder]) or from the default folder for downloads (the hotfix files which are downloaded through the New Version Downloader are marked with [Download] tag).

  • Telerik Assemblies - Select Telerik DPL assemblies which will be added to or removed from your project.

note

If you prefer the Telerik assemblies to be copied into your solution folder, the Copy referenced assemblies to solution and source control option could be selected only into the Visual Studio Extensions Options but it is not applicable for Visual Studio web site projects.

The second page of the Convert Project Wizard gives you the ability to select which theme will be added to your project. Check the content of each theme or see the preview of it when select it into the Convert Project wizard and select the one you want to be included in the project:

introduction-vsx convertewizard themes

On the third page the wizard suggests more site settings and several resource options:

introduction-vsx convertewizard websettings

When a web project gets converted to Telerik one, Visual Studio Extensions perform the following changes:

  • Telerik assembly references get added or are changed in the project.

  • The user gets notified through the Project Configuration wizard if the wizard cannot find a correct Telerik.Web.Design assembly in the GAC.

  • The wizard copies the RadSpell dictionaries and RadCaptcha audio files shipped with the distribution so that they are up to date with the assemblies.

The web.config file gets updated as per the choices in the wizard:

  • The global skin registration is updated.

  • A registration for the "telerik" tag prefix is added, so that it is not needed to have the <%@ Register %> directive in each page.

  • RadScriptManager and RadStyleSheetManager default CDN settings are persisted.