Troubleshooting
Last updated
Was this helpful?
Last updated
Was this helpful?
In case Visual Studio decides not to show the new templates try this:
For Visual Studio 2017 and 2019, open the VS command line and run:
devenv /installVSTemplatesFor Visual Studio 2022, open the VS command line and run:
devenv /updateConfigurationIf it still doesn't work, check if the \Wisej.NET 2 or \Wisej.NET 3 templates are present on your development machine under your user name here:
Documents\Visual Studio (2019|2022)\Templates\ProjectTemplates\Visual C#
Documents\Visual Studio (2019|2022)\Templates\ProjectTemplates\Visual Basic
Starting with Wisej.NET 3.0, we took the approach of distributing the Designer and the templates in a Visual Studio Extension installer (.vsix).
The path to the templates can vary from one machine to another:
%LOCALAPPDATA%\Microsoft\VisualStudio\17.0_{id}\Extensions\{extension_id}
As an example, it can be something like this:
%LOCALAPPDATA%\Microsoft\VisualStudio\17.0_315d49d1\Extensions\x2rkvlci.xbt
If multiple developers use the same machine, installing a VSIX package can become a challenge. To manage this efficiently, you might need to manually install the VSIX package using the Visual Studio Developer Command Prompt. This method ensures that the extension is accessible to all users on the system. You can achieve this by executing the command VSIXInstaller /admin path_to_the_vsix.vsix. This command runs the installer with administrative privileges, making sure the extension is deployed globally rather than limited to a single user profile.
With Wisej.NET 4, developers have access to two distinct designers: one for the .NET Framework (net48) and another for .NET Core (.NET 8.0-windows and later versions).
The designer for the .NET Framework is included in the VSIX installer, which also provides various templates and other Visual Studio add-ons. In contrast, the designer for .NET Core is distributed and updated through the NuGet package that includes Wisej.NET itself.
We also provide the templates to download as another option:
Unblock the zip (this is important!) and expand into:
Documents\Visual Studio (2019|2022)\Templates
Select to overwrite existing files when asked. The zip archives contain the \ItemTemplates and \ProjectTemplates files in the same structure expected by Visual Studio.
>dir %LOCALAPPDATA%\Microsoft\VisualStudio
>del %LOCALAPPDATA%\Microsoft\VisualStudio\{version}\ItemTemplatesCache_{00000000-0000-0000-0000-000000000000}
>del %LOCALAPPDATA%\Microsoft\VisualStudio\{version}\ProjectTemplatesCache_{00000000-0000-0000-0000-000000000000}Templates will not show up when starting a Visual Studio Experimental Instance.
Occasionally you may start getting designer errors when opening a container in design mode. The most common error is "Unable to cast type..." It's a well-known issue related to Visual Studio having to load a shadow copy of the assemblies used at design time.
Since assemblies cannot be unloaded in .NET Framework, Visual Studio loads shadow copies of the assemblies loaded by the designer. Sometimes it ends up loading the same assembly multiple times, leading to the "Unable to cast" error because the same type is loaded more than once.
The WebView2 component can be silently updated by Microsoft, these updates can eventually break Wisej.NET's Edge-based renderer.
In case you encountered this issue, please post in our forum, or contact us via email.
The current workaround for this type of issue is to switch back to the Internet Explorer renderer, this allows you to use the designer with little to no issues, one side effect would be the use of some complex JavaScript components that don't usually work with IE.
We're constantly updating the Designer component, please make sure to follow the forum for any pinned post, usually, those posts would contain links to newer releases of the Wisej.NET Designer.
Usually, it's enough to:
Close all designer tabs
Close all Visual Studio instances
Delete /bin, /obj, /.vs
Open Visual Studio and reload the solution
Recompile
Visual Studio makes shadow copies of the assemblies loaded by the designer here:
%LOCALAPPDATA%\Microsoft\VisualStudio{version}\Designer\ShadowCache
Each installation of Visual Studio has a different unique ID. Visual Studio 2019 versions start with "16.0" and Visual Studio 2022 versions start with "17.0".
>dir %LOCALAPPDATA%\Microsoft\VisualStudio
>del %LOCALAPPDATA%\Microsoft\VisualStudio\{version}\Designer\ShadowCacheRun the >devenv command above again.
If it still doesn't work, delete the Visual Studio templates cache. Each installation of Visual Studio has a different unique ID. Visual Studio 2019 versions start with "16.0" and Visual Studio 2022 versions start with "17.0".
Run the >devenv command above again.
If you still get the problem, try to clean the designer assembly cache and repeat the steps above.
Reopen Visual Studio, recompile again and the problem should be solved.
