diff --git a/installation-and-upgrades/upgrade-project.md b/installation-and-upgrades/upgrade-project.md new file mode 100644 index 000000000..8743ded4e --- /dev/null +++ b/installation-and-upgrades/upgrade-project.md @@ -0,0 +1,85 @@ +--- +title: How to Upgrade Telerik UI for WinForms Project +page_title: How to Upgrade Telerik UI for WinForms Project +description: Learn how to use a specific version of the Telerik UI for WinForms suite in your project. +slug: winforms/installation-deployment-and-distribution/upgrade-project +tags: upgrade, update,Telerik, project, assemblies, NuGet, packages +published: True +position: 4 +--- + +# How to Upgrade Telerik UI for WinForms Project + +This article explains how to upgrade your Telerik UI for WinForms project to a newer version. You can upgrade using one of the following methods: + +- [NuGet Package Manager](#upgrade-via-nuget-package-manager) +- [Manual Assembly Update](#manual-assembly-update) +- [Telerik Visual Studio Extensions](#update-via-telerik-visual-studio-extensions) +- [Updating with Progress Control Panel](#updating-with-progress-control-panel) + + +## Upgrade via NuGet Package Manager + +Upgrading by using NuGet packages is the recommended approach as this method ensures you always have the latest version and simplifies dependency management. + +If you are using NuGet packages, upgrade as follows: + +1. Open your project in Visual Studio. +2. Right-click the project in Solution Explorer and select **Manage NuGet Packages** from the menu. +3. Go to the **Updates** tab. +4. Find the **Telerik.UI.for.WinForms.AllControls** package. +5. Click **Update** to install the latest version, or select a specific version from the dropdown. +6. Wait for the update to complete, then rebuild your project. + +> **Tip:** This is the recommended approach if you are using NuGet packages, as all references are updated automatically. + + +## Manual Assembly Update + +If you are using local assemblies, follow these steps to update them: + +1. **Download the Latest Assemblies** + Download the .zip file containing all binaries for the desired version from your Telerik account. +2. **Unzip the Archive** + Extract the downloaded archive to a folder on your computer. +3. **Remove Old References** + In Visual Studio, open your project and expand the **References** section in Solution Explorer. Select and delete the existing Telerik assemblies. +4. **Add New References** + Right-click on **References** and select **Add Reference...**. Navigate to the unzipped folder and select the required Telerik assemblies. +5. **Build and Run** + Build and run your project to ensure it uses the new version. + +> **Tip** For more information check [Updating Assemblies in a Project]({%slug winforms/installation-deployment-and-distribution/updating-assemblies-in-a-project%}) + +## Update via Telerik Visual Studio Extensions + +You can easily upgrade your Telerik UI for WinForms project using the **Telerik Visual Studio Extensions**. This method provides 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 the best experience. + +To upgrade using Telerik Visual Studio Extensions: + +1. Open your project in Visual Studio. +2. Go to the **Extensions** tab and select **Telerik** > **Telerik UI for WinForms** > **Upgrade Project Wizard**. +3. Follow the prompts in the Upgrade Project Wizard to select the desired Telerik UI for WinForms version and complete the upgrade process. +4. The extension will automatically update the references and resources in your project. +5. Rebuild your project to ensure everything is up to date. + +> **Tip** For more information check [Upgrade Project Wizard]({%slug winforms/installation-deployment-and-distribution/visual-studio-extensions/upgrade-project%}) + +## Updating with Progress Control Panel + +For the most up-to-date and detailed instructions on upgrading Telerik products using the Progress Control Panel, refer to the official documentation below: + +- [How to Update a Product with Progress Control Panel](https://docs.telerik.com/controlpanel/how-to/how-to-update-product) + +## Troubleshooting + +If you encounter issues while upgrading Telerik UI for WinForms, consider the following tips: + +- **Manual Assembly Conflicts:** If you manually update assemblies check [Versions Upgrade]({%slug versions-upgrade%}) +- **Check Documentation:** Refer to the official [Telerik documentation](https://docs.telerik.com/devtools/winforms/installation-and-deployment/updating-assemblies-in-a-project) and [Progress Control Panel guide](https://docs.telerik.com/controlpanel/how-to/how-to-update-product) for more help. +- **Contact Telerik Support:** If problems persist, contact Telerik support for further assistance. + +## See Also + +- [Download Product Files]({%slug winforms/installation-deployment-and-distribution/download-product-files%}) +- [How to Upgrade a Telerik UI for WinForms Project]({%slug how-to-upgrade-a-project%}) \ No newline at end of file diff --git a/installation-and-upgrades/versions-upgrade.md b/installation-and-upgrades/versions-upgrade.md index 7c0bd4dff..1896a74a3 100644 --- a/installation-and-upgrades/versions-upgrade.md +++ b/installation-and-upgrades/versions-upgrade.md @@ -4,8 +4,9 @@ page_title: Versions Upgrade - Installation Deployment and Distribution description: Learn how you can deal with one of the most common errors, after installing a new version of Telrik UI for WinForms. slug: winforms/installation-deployment-and-distribution/versions-upgrade tags: install,nuget -published: True +published: False position: 4 +redirect_to: /knowledge-base/versions-upgrade --- # Versions Upgrade diff --git a/knowledge-base/images/installation-deployment-and-distribution-versions-upgrade001.png b/knowledge-base/images/installation-deployment-and-distribution-versions-upgrade001.png new file mode 100644 index 000000000..462fa69c7 Binary files /dev/null and b/knowledge-base/images/installation-deployment-and-distribution-versions-upgrade001.png differ diff --git a/knowledge-base/versions-upgrade.md b/knowledge-base/versions-upgrade.md new file mode 100644 index 000000000..7fcbaaead --- /dev/null +++ b/knowledge-base/versions-upgrade.md @@ -0,0 +1,32 @@ +--- +title: Version Upgrade +description: Version Upgrade - Installation, Deployment, and Distribution +type: how-to +page_title: Versions Upgrade Error +slug: versions-upgrade +position: 0 +tags: common, upgrade, project, version, installation +res_type: kb +redirect_to: /knowledge-base/versions-upgrade +--- + +## Environment + +|Product Version|Product|Author| +|----|----|----| +|2025.2.520|Telerik UI for WinForms|[Nadya Todorova](https://www.telerik.com/blogs/author/nadya-karaivanova)| + +# Versions Upgrade + +In a .NET Framework project, after [installing a new version]({%slug winforms/installation-deployment-and-distribution/installing-on-your-computer%}) of the Telerik UI for WinForms suite, you may encounter design-time errors and an inability to build your project. + +>caption Figure 1. Visual Studio designer error after installing a new version + +![installation-deployment-and-distribution-versions-upgrade 001](images/installation-deployment-and-distribution-versions-upgrade001.png) + +A common reason for this error is that the project is still referring to the previous version of the Telerik UI for WinForms. In this case, carefully check the references to all Telerik controls in your project and make sure that they are the same version, considering the suffix as well (.462 or .48). Better yet, you can remove all references and add them anew by using the DLLs from your fresh installation. After that, you should rebuild your project, close Visual Studio, and open it again to make sure that no references are kept in memory by Visual Studio. + + +## See Also + +* [Upgrade project]({%slug winforms/installation-deployment-and-distribution/visual-studio-extensions/upgrade-project%})