Designers Troubleshooting Guide
- 5 minutes to read
Perform the following steps if you have problems with a designer:
Close opened windows with the designers in Visual Studio.
Close Visual Studio.
Remove the contents of the Bin and Obj directories of each project in your solution.
Build your solution and ensure that the build succeeded.
Open the designer again. Refer to the following section if it still throws an error:
Common Designers Issues
Problem: A designer throws the “Dictionary already contains class info“ error.
Solution: Refer to the How to avoid the “Dictionary already contains class info” exception when opening Application, Module or Model Editor designers with projects having multiple dependent class libraries article for information on how to avoid this error.
Problem: You receive the “Package Load Failure“ error when you load a designer.
- VS 2015: %ProgramFiles%\Microsoft Visual Studio 14.0\Common7\IDE\
- VS 2017: %ProgramFiles%\Microsoft Visual Studio\2017\Professional\Common7\IDE\
- VS 2019: %ProgramFiles%\Microsoft Visual Studio\2019\Professional\Common7\IDE\
After that, execute the following command in the command prompt:
It is also possible that extensions do not load because the Visual Studio component’s cache is corrupted. Clear the cache as described in the following articles:
Model Editor Issues
Problem: Model changes are shown as a plain XML instead of in the designer.
Solution #1: Refer to the previous solution. See the following solution if the Model Editor still does not work.
For .NET Core 3+ & .NET 5 projects:
Ensure the DevExpress.ExpressApp.Design.NetCorePackage extension is enabled. To do this, click the Extensions | Manage extensions menu item, and in the invoked window, click the Enable button (if the extension is disabled). Restart Visual Studio.
For the .NET Framework projects:
Ensure the DevExpress.ExpressApp.Design.CorePackage extension is enabled. To do this, click the Extensions | Manage extensions menu item, and in the invoked window, click the Enable button (if the extension is disabled). Restart Visual Studio.
You can disable this extension when you received the following notification:
We recommend that you do not disable DevExpress extensions as this may cause functionality issues.
This extension can be disabled due to a corrupted installation. Refer to the articles below for more information.
- Extensions get automatically disabled when starting VS 2015
- Web Essentials disabled on VS 2015 start
Solution #3: Ensure that the “Subtype Designer” is added unnecessarily to xml-based files like csproj issue is fixed in the version of Visual Studio you use. Otherwise, update your IDE.
Problem: Your Model changes are contained in the XAFML file, but are not applied to an application or higher level modules.
Solution: Ensure that:
the Model.DesignedDiffs.xafml file’s Build Action is set to EmbeddedResource;
your changes are not overridden in higher application model layers. For example, if you customized the Model in a platform-agnostic module, check the Model.DesignedDiffs.xafml or Model.xafml files of your platform-dependent module and project, respectively.
Problem: You have one of the following issues in a .NET Standard 2.0+/.NET Core 3+/.NET 5 project:
- The Model Editor frame was created, but showed errors inside.
- The Model Editor frame was not created.
- You received NotImplementedException.
- You received the “The operation could not be completed” error.
Solution: Follow the steps below to collect diagnostic information and send it to DevExpress Support.
- Close your Visual Studio, navigate to
%USERPROFILE%\AppData\Roaming\eXpressAppFramework\, and archive the folder content.
- If the Model Editor frame was not created or you received NotImplementedException or “The operation could not be completed” errors, collect the inner exception message and callstacks using another Visual Studio instance. The following article describes how to do this: How to obtain a design-time exception call stack.
- Create a new Support Center ticket (https://supportcenter.devexpress.com/ticket/create) and attach the resulting diagnostic information as well as screenshots showing the exact steps to reproduce, the actual and expected results, your Visual Studio “About” information, and the CSPROJ/VBPROJ of the projects you tested. Optionally, attach a small debuggable sample where this behavior can be reproduced in a stable manner.
Controller Designer Issue
Problem: You receive the following error when you open a Controller in the designer, or the Controller is shown as a plain text instead of the designer:
Solution: Refer to the ViewController<ViewType> class description.
Problem: You received any other errors.
Solution: Debug Visual Studio where designers are opened as described in the How to obtain a design-time exception call stack KB Article.
Problem: You did not find an appropriate solution in this topic.
Solution: Close Visual Studio and rerun the DXperience installation in the Repair mode.
Do not start Visual Studio until the installation is completed.