New to Telerik UI for WinForms? Download free 30-day trial

Upgrade project

An important feature in the Visual Studio Extensions is the Project Upgrade Wizard.

The Upgrade Wizard (started by using the Telerik > Telerik UI for WinForms > Upgrade Wizard menu item) is used to change the version of Telerik UI for WinForms your projects use.

In addition to the pure assembly reference change, the upgrade wizard provides several important features:

  • Check if a new version of Telerik UI for WinForms is available on the Telerik website.

  • Download of a newly discovered version.

  • Visual Studio toolbox update.

  • Project themes upgrade.

  • Current project backup.

On the first step the wizard provides basic update process information:

installation-deployment-and-distribution-vsx-upgrade-project 001

On the next step the wizard lists all projects from the solution, which use Telerik UI for WinForms. You can choose which projects will be updated (it is recommended to upgrade all projects to the chosen version, not just part of them) and the version which they will be upgraded to. The Compatibility button will invoke the Upgrade API Analyzer tool:

installation-deployment-and-distribution-vsx-upgrade-project 002

The next screen allows you to update the Visual Studio Toolbox with the newly selected controls, so that you avoid accidental reference change during a control drag and drop, as well as creating a backup of your project:

installation-deployment-and-distribution-vsx-upgrade-project 003


  • The Telerik UI for WinForms distribution selection screen lists all the versions that can be detected automatically. These are versions, installed by using the Windows Installer MSI package, versions, downloaded by the Upgrade Wizard and versions, available in the GAC. Hotfixes, downloaded manually cannot be detected.

  • You can use the GET LATEST button to access the Latest Version Acquirer and download the latest available version on our website.

  • The distribution, downloaded by the Upgrade Wizard contains only the "hotfix" files, e.g. the barebone files, needed for a project to run correctly. It does not contain the documentation or the Live Examples.

  • A Visual Studio restart will be required in order to update your toolbox. If the automatic restart fails, a restart should be initiated manually in order to complete the toolbox upgrade.

See Also

In this article