You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The **Project Upgrade Wizard** is an essential feature of the Telerik Visual Studio Extensions that streamlines the process of upgrading your Telerik UI for WinForms projects to newer versions.
15
15
16
-
An important feature in the Visual Studio Extensions is the __Project Upgrade Wizard__.
16
+
## Overview
17
17
18
-
The Upgrade Wizard (started by using the __Telerik > Telerik UI for WinForms > Upgrade Wizard__ menu item) is used to change the version of __Telerik UI for WinForms__your projects use.
18
+
The Upgrade Wizard can be accessed in Visual Studio by **Extensions > Telerik > Telerik UI for WinForms > Upgrade Wizard**. It simplifies the process of changing the Telerik UI for WinForms version used in your projects. This tool ensures a smooth transition between versions while maintaining project integrity.
19
19
20
-
In addition to the pure assembly reference change, the upgrade wizard provides several important features:
20
+
## Prerequisites
21
21
22
-
* Check if a new version of __Telerik UI for WinForms__ is available on the Telerik website.
22
+
Before using the Project Upgrade Wizard, ensure that:
23
23
24
-
* Download of a newly discovered version.
24
+
- You have the latest version of Telerik Visual Studio Extensions installed
25
+
- Your project currently uses Telerik UI for WinForms controls
26
+
- Visual Studio is closed for any projects you plan to upgrade (recommended)
25
27
26
-
* Visual Studio toolbox update.
28
+
## Key Features
27
29
28
-
* Project themes upgrade.
30
+
In addition to updating assembly references, the upgrade wizard provides several important additional features:
29
31
30
-
* Current project backup.
32
+
-**Version Detection**: Automatically checks if a new version of Telerik UI for WinForms is available on the Telerik website
33
+
-**Automatic Download**: Downloads newly discovered versions directly from the wizard
34
+
-**Toolbox Integration**: Updates the Visual Studio toolbox with the new control versions
35
+
-**Theme Upgrade**: Upgrades project themes to be compatible with the new version
36
+
-**Backup Creation**: Creates a backup of your current project before making changes
37
+
-**Batch Processing**: Upgrades multiple projects in a solution simultaneously
31
38
32
-
On the first step the wizard provides basic update process information:
39
+
## Step-by-Step Upgrade Process
40
+
41
+
### Step 1: Initialize the Upgrade Wizard
42
+
43
+
You can find the Upgrade Wizard when you select the solution file in Visual Studio, then go to **Extensions > Telerik > Telerik UI for WinForms > Upgrade Wizard**.
Alternatively, you can right-click on a project file with the mouse, then select **Telerik UI for WinForms > Upgrade Wizard** from the menu.
48
+
49
+
### Step 2: Upgrade Wizard Information
50
+
51
+
The wizard starts with an overview of the upgrade process, providing essential information about what will be updated and any important considerations.
On the next step the wizard lists all projects from the solution, which use Telerik UI for WinForms. 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. The Compatibility button will invoke the [Upgrade API Analyzer tool](http://docs.telerik.com/devtools/winforms/api-analyzer):
55
+
### Step 3: Select Projects and Target Version
56
+
57
+
The wizard displays all projects in your solution that use Telerik UI for WinForms. Here you can:
58
+
59
+
-**Select Projects**: Choose which projects to upgrade. It's recommended to upgrade all projects to maintain version consistency in your solution.
60
+
-**Choose Target Version**: Select the Telerik UI for WinForms version to upgrade.
61
+
-**Check Compatibility**: Use the **Compatibility** button to invoke the [Upgrade API Analyzer tool](http://docs.telerik.com/devtools/winforms/api-analyzer) to identify potential breaking changes.
62
+
63
+
>note Upgrading all projects in a solution to the same version prevents compatibility issues and ensures consistent behavior across your application.
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:
67
+
68
+
### Step 4: Configure Toolbox and Backup Options
69
+
70
+
The final configuration screen allows you to:
71
+
72
+
-**Update Toolbox**: Update the Visual Studio Toolbox with the newly selected control versions to prevent accidental reference mismatches during drag-and-drop operations.
73
+
-**Create Backup**: Create a backup of your current project before applying changes (highly recommended).
* The Telerik UI for WinForms distribution selection screen lists all the 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, available in the GAC. Hotfixes, downloaded manually cannot be detected.
78
+
### Step 5: Visual Studio Restart
47
79
48
-
* You can use the __GET LATEST__ button to access the Latest Version Acquirer and download the latest available version on our website.
80
+
Visual Studio will restart automatically to complete the toolbox update. If automatic restart fails, manually restart Visual Studio to finish the upgrade process. This ensures all new controls are properly registered in the toolbox.
49
81
50
-
* The distribution, downloaded by the Upgrade Wizard contains only the "hotfix" files, e.g. the barebone files, needed for a project to run correctly. It does not contain the documentation or the Live Examples.
82
+
## Important Notes and Considerations
51
83
52
-
* 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.
84
+
#### Version Detection
85
+
- The distribution selection screen automatically detects versions installed via Windows Installer MSI package
86
+
- Versions downloaded by the Upgrade Wizard are detected
87
+
- Versions available in the Global Assembly Cache (GAC) are detected
88
+
-**Limitation**: Manually downloaded hotfixes cannot be automatically detected
53
89
54
-
# See Also
90
+
#### Latest Version Access
91
+
- Use the **GET LATEST** button to access the [Latest Version Acquirer]({%slug winforms/installation-deployment-and-distribution/visual-studio-extensions/latest-version-acquirer%})
92
+
- This feature downloads the most recent version available from the Telerik website
93
+
- Ensures you always have access to the newest features and bug fixes
- Documentation and Live Examples are not included in wizard downloads
98
+
- For complete installations with documentation, use the full [MSI installer]({%slug winforms/installation-deployment-and-distribution/installing-on-your-computer%})
59
99
60
-
*[Download New Version]({%slug winforms/installation-deployment-and-distribution/visual-studio-extensions/latest-version-acquirer%})
61
100
62
-
*[How to Upgrade a Telerik UI for WinForms Project]({%slug how-to-upgrade-a-project%})
0 commit comments