# 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](/docs/getting-started-1/troubleshooting.md#download-templates).

<div align="left"><img src="/files/Wq2boPnLNgY9JLaBveDn" alt=""></div>

2\. **Close** all instances of Visual Studio.

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

4\. **Reopen** Visual Studio.

{% content-ref url="/pages/VL9AfTmjE5vAOdFl0oWz" %}
[Troubleshooting](/docs/releases/whats-new-in-3.0/troubleshooting.md)
{% endcontent-ref %}

## 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**).

{% hint style="warning" %}
Ensure that you restore **net48** to the first listed framework in **TargetFrameworks** to load the designer.
{% endhint %}

### **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**).

{% hint style="warning" %}
Ensure that you restore **net48** to the first listed framework in **TargetFrameworks** to load the designer.
{% endhint %}

## 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.**

{% hint style="info" %}
You may also need to clear the [Visual Studio Designer cache](/docs/getting-started-1/troubleshooting.md#clear-designer-assembly-cache).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wisej.com/docs/releases/whats-new-in-3.0/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.