Upgrade from 1.x
Last updated
Last updated
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.
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"
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.
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.