Upgrading a Trial to a Developer License or to a Newer Version

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.

Upgrade to a Newer Version of Telerik® UI for ASP.NET AJAX

To upgrade the Telerik controls in your project:

1. Install the new version by using your preferred installation package.

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

You can upgrade the controls either automatically or manually.

Automatic Upgrade

The automatic upgrade is possible if you use the UI for ASP.NET AJAX Visual Studio extensions. To perform the automatic upgrade:

1. Use the UI for ASP.NET AJAX Visual Studio extensions to download the latest version.

2. Use the Upgrade Wizard to upgrade the control in your project.

The Upgrade Wizard does not modify the <bindingRedirect> sections in the web.config file or the entries in the licenses.licx file. If you encounter errors such as "Could not load file or assembly 'Telerik.Web.UI'" after an upgrade, check that the web.config includes binding redirects for old assembly versions. Additionally, ensure the licenses.licx file does not contain outdated entries; deleting the file contents, saving it and rebuilding the solution can regenerate it with the correct references.

Manual Upgrade

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:

1. Backup your project. A simple copy to another folder is usually enough, and using a source control makes this unnecessary.

2. Delete the old Telerik.Web.UI.* references from the project and close it. Delete also the Skins and Design assemblies. You can find more information on how to update the assembly reference in an ASP.NET Web Forms application here.

3. Open the Bin folder of your project in Windows Explorer and delete the old Telerik.Web.UI.* assemblies.

4. Copy the new assemblies from the corresponding Bin* folder in the UI for ASP.NET AJAX installation path:

   • Bin462: Contains the assemblies for .NET 4.6.2 and above.

   • Bin45: Contains the assemblies for .NET 4.5 (distributed until 2024 Q1).

   • The Bin40 folder contains the assemblies for .NET 4.0 (distributed until R1 2023 SP1).

   • The Bin35 folder contains the assemblies for .NET 3.5 (distributed until R1 2023 SP1).

   • If you install a hotfix, go to the folder where you unzipped it.

5. Paste the new assemblies in the Bin folder of your project in Windows Explorer.

6. Open the project in Visual Studio and add references to the Telerik assemblies.

7. 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. Additionally, ensure that the sections in the web.config file are updated to match the new assembly versions to avoid errors such as "Could not load file or assembly 'Telerik.Web.UI'". Also, check the licenses.licx file for outdated entries; deleting this file contents and rebuilding the solution will regenerate it with the correct references.

You can use the copy-and-replace method to upgrade any other assemblies, localization files (~/App_GlobalResources), dialogs (RadImageEditor, RadEditor), TypeScript definitions, etc.

Upgrade From Trial to Licensed Version of Telerik® UI for ASP.NET AJAX

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:

1. Download the licensed version of UI for ASP.NET AJAX.

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

See Also

• Troubleshoot Upgrade Issues

• Which File Do I Need to Install?

• Included Assemblies

• Getting tired of seeing trial messages in your ASP.NET AJAX application?

• web.config Settings Overview

• DLL Hell Strikes Again Blog Post by Damien White

• How to fix License File related errors