Skip to main content

Upgrade from 1.x

To upgrade from Wisej.NET 1.x, replace the assembly references and update namespaces used by design-time features. Follow the checklist below for the required project changes.

Upgrade Checklist​

  • Set target .NET Framework to 4.8
danger

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
warning

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

info

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

Wisej.NET 2.x NuGet Package

info

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

Wisej.NET 3.x Nuget Package

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

Replacing Wisej.Web by Wisej.Framework

warning

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". A sample Web.config file:

Web.config

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

New SDK Format​

Wisej.NET 3.0 introduced support for .NET 6, which requires the SDK Project Format.

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

tip

There is no need to change the project format if you are staying with .NET 4.8! Wisej.NET 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.
The extension is downloaded from wisej.com/builds and installed like any VSIX; see Getting Started.

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

Wisej.NET 2.X Visual Studio Designer