Troubleshooting

Missing Templates

1. Verify the templates are located in

   • My Documents\Visual Studio 2022\Templates\Project Templates\Visual C#

   • My Documents\Visual Studio 2022\Templates\Project Templates\Visual Basic

   • If the \Wisej.NET 3 directory is missing, run the installer again or download the templates from this page.

2. Close all instances of Visual Studio.

3. Run devenv /updateconfiguration as Administrator in the Developer Command Prompt.

4. Reopen Visual Studio.

Troubleshooting

Docker

Your Docker server host is configured for 'Linux', however your project targets 'Windows'...

Ensure that you are targeting the correct framework. This error will occur when net48 is the first-listed framework in TargetFrameworks. Temporarily switch net48 with your Docker runtime target (net5 / net6).

Ensure that you restore net48 to the first listed framework in TargetFrameworks to load the designer.

There were build errors. Would you like to continue and run the latest successful build?

Ensure that you are targeting the correct framework. This error will occur when an incorrect framework is loaded into the Docker container. Temporarily switch the first-listed TargetFramework with your Docker runtime target (net5 / net6).

Ensure that you restore net48 to the first listed framework in TargetFrameworks to load the designer.

Designer Errors

Missing Designer

Occasionally when creating a new Wisej.NET 3 project using .NET48 and .NET6+ the designer will not be visible upon project creation. Rebuild the project and then restart Visual Studio.

Designer Error

The most common designer error is "Unable to cast object of type ‘Wisej.Web.Page’ to type ‘Wisej.Core.IWisejControl’ (or another base type).

This issue occurs when trying to loading multiple versions of Wisej.NET into one Visual Studio instance. Visual Studio loads the Wisej.NET designer assembly for the first page that is shown in the designer. If you open a page from a different project using a different version of Wisej, you will get this error.

Simply restart Visual Studio and re-open the new page.

You may also need to clear the Visual Studio Designer cache.