Upgrade your project to AjaxControlToolkit v15.1
: The ASP.NET AJAX Control Toolkit v15.1 now requires that your project is using .NET framework v4.0 or higher. Projects targeting .NET framework v3.5 have to be migrated to a more recent .NET version before upgrading.
0 - Remove previous version
Make sure your have removed previous versions before installing ASP.NET AJAX Control Toolkit v15.1:
- If you have added the toolkit to Toolbox via the “Choose items...” dialog, remove an assembly reference and reset your toolbox.
- If you have added the toolkit via the NuGet package manager, simply uninstall the package from the solution.
1 - Install
To install the ASP.NET AJAX Control Toolkit v15.1 go to the
and get the new Installer (created by
If you use the fully-qualified name for the ASP.NET AJAX Control Toolkit assembly, then please ensure that all occurrences are updated (this includes references in web.config and @Register directives in the ASPX markup).
2 - Replace ToolkitScriptManager with ScriptManager
The ToolkitScriptManager has been deprecated for the v15.1 release. Please use the standard ScriptManager control. It should be sufficient to change the tag name in the markup from <yourTagPrefix>:ToolkitScriptManager -> asp:ScriptManager. If you find
any issues, then
please report them here
Refer to the "ToolkitScriptManager Removed in
v15.1, Use ScriptManager
" article for details.
3 - Clean up Web.config
Remove the following outdated elements from your project’s web.config file:
// (in system.web/httpHandlers and system.webServer/handlers sections).
<add name="CombineScriptsHandler" verb="*" path="CombineScriptsHandler.axd" type="AjaxControlToolkit.CombineScriptsHandler, AjaxControlToolkit"/>
// (in system.web section)
<section name="sanitizer" requirePermission="false" type="AjaxControlToolkit.Sanitizer.ProviderSanitizerSection, AjaxControlToolkit"/>
// (in system.web section)
. . .
4 - Use Microsoft.Web.Optimization for bundling and minification
The AjaxControlToolkit.CombineScriptsHandler have been removed for v15.1 and resource bundling was delegated to the
ASP.NET Web Optimization Framework
Find the detailed description and instructions on enabling it in the following article:
How to use bundling and CDN
Note: if you use named
(defined in the ~/AjaxControlToolkit.config file), then adjust the script bundle virtual path as shown below:
5 - Html Editor
The following namespaces have been renamed so please update your code accordingly:
To reduce the number of dependencies, we have moved Html Sanitizer out to an external NuGet package:
For security concerns, we recommend that you always use Html Editor together with Html Sanitizer.
If you have any questions regarding upgrading your projects then open a ticket in the