Upgrade from 1.x

Upgrading from Wisej.NET 1.X to recent Wisej.NET versions is extremely easy. All you need to do is replace the references and make sure some "using" statements referring to design-time features are updated.

Upgrade Checklist

  • Set target .NET Framework to 4.8

Setting the target .NET Framework to 4.8 is crucial to avoid any issues when installing or compiling your application

  • Replace project references to Wisej.Web.dll and Wisej.Core.dll with a NuGet Package reference

It's highly recommended that you use the new PackageReference format instead of the old Packages.config file for managing your Packages. Click here for more info.

For Wisej.NET 2.X make sure to use the "Wisej-2" NuGet Package.

For Wisej.NET 3.X make sure to use the "Wisej-3" NuGet Package.

  • Replace .resx namespaces to Wisej.Web. and Wisej.Core. with Wisej.Framework. You can do that by doing a mass replacement. From Visual Studio, go to Edit > Find and Replace > Replace in Files or simply use the Ctrl+Shift+H Hotkey.

Make sure to edit the File types field to only include RESX files.

  • Change using Wisej.Core.Design to using Wisej.Design using the same process as the previous step, although this time change the File type from RESX files to CS files.

  • Change calls from ApplicationBase. to Application, again following the same process as the previous step.

  • Modify Web.config and replace "Wisej.Core" with "Wisej.Framework"

<?xml version="1.0" encoding="utf-8"?>
  For more information on how to configure your ASP.NET application, please visit
    <add key="Wisej.LicenseKey" value="" />
    <add key="Wisej.DefaultTheme" value="Bootstrap-4" />
    <compilation debug="true" />
    <httpRuntime targetFramework="4.8" maxRequestLength="1048576" />
      <add name="Wisej" type="Wisej.Core.HttpModule, Wisej.Framework" />
    <validation validateIntegratedModeConfiguration="false" />
      <add name="json" verb="*" path="*.json" type="System.Web.HttpForbiddenHandler" />
      <add name="wisej" verb="*" path="*.wx" type="Wisej.Core.HttpHandler, Wisej.Framework" />
        <requestLimits maxAllowedContentLength="1073741824" />
    <defaultDocument enabled="true">
        <add value="Default.html" />
	Uncomment the trace listener below to enable logging to a log file.
		<trace autoflush="true" indentsize="4">
			<remove name="Default" />
			<add name="Default" type="System.Diagnostics.TextWriterTraceListener" initializeData="Trace.log" />
<!--ProjectGuid: f56c9a70-bc66-49ef-957b-6de7ca9980d5-->

New SDK Format

Wisej.NET 3.0 introduced the ability to target .NET 6, with this change came the need to introduce the new SDK Project Format.

If you're aiming to migrate to .NET 6 or newer, click here for more info.

There is no need to change the project format if you are staying with .NET 4.8! Wisej 3 supports both .NET Framework and .NET Core. You only need to change the project format to the SDK format if you are going to use .NET Core and ASP.NET Core.

Designer and Templates

Starting with Wisej.NET 3.0, we're now shipping the Designer and Templates as VSIX installers. This gives you the ability to manage updates directly from Visual Studio's Extension Manager.

For Wisej.NET 2.X , you can install the designer as its own NuGet Package.

Templates can also be manually installed, click here for more info.

Last updated