This article explains how to upgrade the version of the Telerik® UI for ASP.NET AJAX controls and how to switch from a Trial to a Developer license.
To upgrade the Telerik controls in your project:
Install the new version by using your preferred installation package.
Replace the Telerik assemblies with their newer versions and update their references in the project.
Before upgrading your project, review the following resources:
The Known Issues and Important Changes thread lists changes and known regression issues that may affect your code.
The Telerik Upgrade API Analyzer analyzes your C# code and notifies you of changes between your version and the new version.
The UI for ASP.NET AJAX Release Notes list all changes, fixes, new features and controls.
The automatic upgrade is possible if you use the UI for ASP.NET AJAX Visual Studio extensions. To perform the automatic upgrade:
Use the UI for ASP.NET AJAX Visual Studio extensions to download the latest version.
Use the Upgrade Wizard to upgrade the control in your project.
The manual upgrade gives you the freedom to control each step of the process. In short, you just need to replace the assembly references with the new ones.
The following steps ensure a safe upgrade:
Backup your project. A simple copy to another folder is usually enough, and using a source control makes this unnecessary.
Delete the old Telerik.Web.UI.* references from the project and close it. Delete also the Skins and Design assemblies.
Binfolder of your project in Windows Explorer and delete the old Telerik.Web.UI.* assemblies.
Copy the new assemblies from the corresponding
Bin*folder in the UI for ASP.NET AJAX installation path:
Bin45folder contains the assemblies for .NET 4.5 and above.
Bin40folder contains the assemblies for .NET 4.0.
Bin35folder contains the assemblies for .NET 3.5.
If you install a hotfix, go to the folder where you unzipped it.
Paste the new assemblies in the
Binfolder of your project in Windows Explorer.
Open the project in Visual Studio and add references to the Telerik assemblies.
Make sure you have all necessary web.config registrations
As with any ASP.NET project, it is often helpful to clear the ASP Temporary files and the browser cache.
The trial version and the licensed version of UI for ASP.NET AJAX have different assemblies, this why you don't need a license key or an activation to upgrade. Instead, you must replace the trial assemblies with the licensed assemblies.
To upgrade to a licensed version:
Download the licensed version of UI for ASP.NET AJAX.
Follow the steps in the Upgrade to a Newer Version of Telerik® UI for ASP.NET AJAX section to delete the trial assemblies and replace them with the developer versions.
You should delete (or uninstall) the Trial version from your machine before upgrading to the licensed version. Doing so eliminates the chance of trial assemblies still making it into the project references or even production.
If you are getting trial errors similar to "Thank you for using the Trial Version of Telerik® UI for ASP.NET Ajax to build more powerful applications faster. Purchase the Commercial Version now to get access to all product updates and the Telerik expert support" or "Telerik.Web.UI 201X.X.XXX.XX trial version. Copyright Telerik © 2002-201X. To remove this message, please purchase a developer version." check out the dedicated Getting tired of seeing trial messages in your ASP.NET AJAX application? blog post.