[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Collapse]Common Concepts
  [Expand]Web.config Modifications
  [Expand]Callback Exception Handling
  [Expand]Client-Side Functionality
  [Expand]Cookies Support
  [Expand]Appearance Customization - Theming
   Icon Collection
  [Expand]Performance Optimization
  [Expand]CSS Image Sprites
   Supported Document Types
  [Expand]Accessibility Support
   Right to Left Support
   HTML Encoding
   Binary Storage Configuration
  [Collapse]SharePoint Support
   [Expand]Ready to Use Web Parts
   [Collapse]Developer Capabilities
     Installation and Deployment
     Upgrading to a Newer Version
     Visual Web Part Creation
     SharePoint Page Editing
     Web Part Creation
    SharePoint Troubleshooting Guide
   Mobile Support
  [Expand]Office Document Management
   Cloud Storage Account Management
  [Expand]Web Farm and Web Garden Support
 [Expand]ASP.NET WebForms Controls
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Upgrading to a Newer Version

Since SharePoint maintains its files and modification history, it is necessary to perform the following steps to delete/upgrade the deployed Web Parts with DevExpress controls and modified SharePoint Pages.

  1. If you have previously modified certain SharePoint Pages directly using the SharePoint Designer, then edit the corresponding page with the SharePoint Designer in Advanced Mode, and comment out the DevExpress Register directives and control markup using the <%--…--%> expression.
  2. Remove Web Parts that use DevExpress controls from all pages.
  3. 1) Edit the corresponding page using the Site Action -> Edit Page command.
    2) Select the required Web Part.
    3) Click the Delete command within the Smart Tag menu.

  4. Remove all Web Parts from the Site Actions -> Site Settings -> Galleries -> Web Parts menu.
  5. Make sure that there are no DevExpress entries in the Web.config file.
  6. Clear the corresponding "Temporary ASP.NET Files" directory (the c:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files\ for SharePoint 2013 and SharePoint 2016). This may require stopping the IIS process using the following command.

    iisreset /stop

  7. Restart the IIS using the following command.

    iisreset

  8. Examine the problematic pages, and check to see if they operate properly and that there are no errors or warning messages.
  9. Register a new version of the DevExpress Web.config entries. See the Installation and Deployment help topic for more information.
  10. If you have modified certain SharePoint Pages directly, then edit the corresponding page using the SharePoint Designer in Advanced Mode: remove comment expressions from the DevExpress Register directives and control markup, and update the DevExpress Register directives according to the new DevExpress version.
  11. Upgrade the source folder of Web Part projects that use DevExpress controls using the Project Converter tool. See the Upgrade Notes help topic for more information.
  12. Remove the Properties -> licenses.licx file, the Bin folder and the Obj folders.
  13. Rebuild and redeploy the upgraded Web Parts projects.
  14. Insert the required Web Part into the required page.
  15. Examine the problematic pages and check to see if they operate properly, and that there are no errors or warning messages.

Expanded See Also

Is this topic helpful?​​​​​​​