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

Upgrade Projects

An important feature of Progress Telerik UI for WPF Extension is the Project Upgrade Wizard.

The Upgrade Wizard (started by using the Extensions > Telerik UI for WPF > Upgrade Wizard menu item) is used to change the version of Telerik UI for WPF your project uses.

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

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

  • Download of a newly discovered version.

  • Visual Studio toolbox update.

  • Project themes upgrade (when using implicit styles).

  • Current project backup.

On the first step the wizard provides basic update process information

VSExtentions WPF Upgrade Wizard Initial Page

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 and whether or not all binaries should get copied to your solution folder (useful when utilizing a build server or working on a project collaboratively). The Compatibility button will invoke the Upgrade API Analyzer tool:

VSExtentions WPF Upgrade Wizard

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:

VSExtentions WPF Upgrade Wizard Toolbox

Notes

  • The distribution selection screen lists all the Telerik UI for WPF 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.

  • 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 .dll and related files, e.g. the barebone files, needed for a project to run correctly. It does not contain the documentation or any code examples.

    VSExtensions Themes Folder

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

  • The Upgrade Wizard won't work if the Telerik assemblies are installed with a NuGet package. In this case, you can update the package via the NuGet Package Manager.

See Also

In this article