|
| 1 | +--- |
| 2 | +title: How to Upgrade Telerik UI for WinForms Project |
| 3 | +page_title: How to Upgrade Telerik UI for WinForms Project |
| 4 | +description: Learn how to use a specific version of the Telerik UI for WinForms suite in your project. |
| 5 | +slug: winforms/installation-deployment-and-distribution/upgrade-project |
| 6 | +tags: upgrade, update,Telerik, project, assemblies, NuGet, packages |
| 7 | +published: True |
| 8 | +position: 4 |
| 9 | +--- |
| 10 | + |
| 11 | +# How to Upgrade Telerik UI for WinForms Project |
| 12 | + |
| 13 | +This article explains how to upgrade your Telerik UI for WinForms project to a newer version. You may upgrade your project using one of the following methods: |
| 14 | + |
| 15 | +- [NuGet Package Manager](#upgrade-via-nuget-package-manager) |
| 16 | +- [Telerik Visual Studio Extensions](#update-via-telerik-visual-studio-extensions) |
| 17 | +- [Manual Assembly Update](#manual-assembly-update) |
| 18 | +- [Updating with Progress Control Panel](#updating-with-progress-control-panel) |
| 19 | + |
| 20 | +## Upgrade via NuGet Package Manager |
| 21 | + |
| 22 | +Upgrading by using NuGet packages is the recommended approach as this method ensures you always have the latest version and simplifies dependency management. |
| 23 | + |
| 24 | +If you are using NuGet packages, upgrade as follows: |
| 25 | + |
| 26 | +1. Open your project in Visual Studio. |
| 27 | +1. Right-click the project in Solution Explorer and select **Manage NuGet Packages** from the menu. |
| 28 | +1. Go to the **Updates** tab. |
| 29 | +1. Find the **Telerik.UI.for.WinForms.AllControls** package. |
| 30 | +1. Click **Update** to install the latest version, or select a specific version from the dropdown. |
| 31 | +1. Wait for the update to complete, then rebuild your project. |
| 32 | + |
| 33 | +> **Tip:** This is the recommended approach if you are using NuGet packages, as all references are updated automatically. |
| 34 | +
|
| 35 | +## Upgrade via Telerik Visual Studio Extensions |
| 36 | + |
| 37 | +You can easily upgrade your Telerik UI for WinForms project using the [Visual Studio Extensions for Telerik UI for WinForms]({%slug winforms-installation-deployment-and-distribution-visual-studio-extensions%}). The Telerik extensions provide a user-friendly interface for managing Telerik references and resources directly within Visual Studio. Make sure you have the latest version of the Telerik Extensions installed for a better user experience. |
| 38 | + |
| 39 | +To upgrade using Telerik Visual Studio Extensions: |
| 40 | + |
| 41 | +1. Open your project in Visual Studio. |
| 42 | +1. Go to the **Extensions > Telerik > Telerik UI for WinForms > Upgrade Project Wizard**. |
| 43 | +1. Follow the prompts in the Upgrade Project Wizard to select the desired Telerik UI for WinForms version and complete the upgrade process. |
| 44 | +1. The extension will automatically update the references and resources in your project. |
| 45 | +1. Rebuild your project to ensure everything is up to date. |
| 46 | + |
| 47 | +> **Tip** For more information check [Upgrade Project Wizard]({%slug winforms/installation-deployment-and-distribution/visual-studio-extensions/upgrade-project%}) |
| 48 | +
|
| 49 | +## Manual Assembly Upgrade |
| 50 | + |
| 51 | +If you are using local assemblies or have just installed Telerik UI for WinForms using the MSI installer, you should manually update your Telerik assemblies in the project. Follow the steps below to do so: |
| 52 | + |
| 53 | +1. Navigate to the folder containing all the latest Telerik assemblies for the desired version. If using msi installer, it usually creates a folder at `C:\Program Files (x86)\Progress\Telerik UI for WinForms 2025 Q2`. |
| 54 | +1. Remove old Telerik assemblies from your project references. In Visual Studio, open your project and expand the References section in Solution Explorer. Select and delete the existing Telerik assemblies. |
| 55 | +1. Right-click on References and select *Add Reference...*. Navigate to the folder of your fresh installation and select the required Telerik assemblies. |
| 56 | +1. Clean, then rebuild your project to ensure it uses the new version. |
| 57 | + |
| 58 | +> **Tip** For more information, please check [Updating Assemblies in a Project]({%slug winforms/installation-deployment-and-distribution/updating-assemblies-in-a-project%}) |
| 59 | +
|
| 60 | +## Upgrade using Progress Control Panel |
| 61 | + |
| 62 | +For the most up-to-date and detailed instructions on upgrading Telerik products using the [Progress Control Panel](https://docs.telerik.com/controlpanel/introduction), refer to the official documentation: [How to Update a Product with Progress Control Panel](https://docs.telerik.com/controlpanel/how-to/how-to-update-product) |
| 63 | + |
| 64 | +## Troubleshooting |
| 65 | + |
| 66 | +If you encounter issues while upgrading your Telerik UI for WinForms project, consider the following tips: |
| 67 | + |
| 68 | +- **Manual Assembly Conflicts:** If you manually update assemblies check [Versions Upgrade]({%slug versions-upgrade%}) |
| 69 | +- **Check Documentation:** Refer to the official [Telerik documentation]({%slug winforms/overview%}) |
| 70 | +- **Contact Telerik Support:** If problems persist, contact Telerik support for further assistance. |
| 71 | + |
| 72 | +## See Also |
| 73 | + |
| 74 | +- [Download Product Files]({%slug winforms/installation-deployment-and-distribution/download-product-files%}) |
| 75 | +- [How to Upgrade a Telerik UI for WinForms Project]({%slug how-to-upgrade-a-project%}) |
0 commit comments