What's new in 4.0
Wisej.NET 4 Introduction
Last updated
Was this helpful?
Wisej.NET 4 Introduction
Last updated
Was this helpful?
Wisej.NET 4 introduces significant improvements driven by two main factors:
The adoption of a .NET Core-only designer
The replacement of GDI+ with our managed graphics system
The .NET Core-only designer, in addition to the existing .NET Framework 4.8 designer enables projects to use the latest .NET Core libraries without maintaining .NET Framework compatibility.
Replacing GDI+ with our managed System.Drawing library standardizes font measurements across platforms and removes the need for libgdiplus on Linux systems.
It is crucial to ensure that any changes made by the designer can be undone and recovered. This ability is essential because if the designer serialization behaves unexpectedly, there is a risk of losing code.
We will extend the . This includes continuing to offer bug fixes and enhancements to ensure stability and reliability for users who are transitioning to version 4.0.
Rebuilding Wisej.NET designers for the out-of-process .NET Core Designer required substantial changes and may present challenges in upcoming builds. Please be prepared to troubleshoot potential issues as we refine the implementation.
Because Visual Studio uses the .NET Framework, Microsoft divided the designer into two parts: the "client" component running on the .NET Framework within Visual Studio and the "server" component running in a hidden .NET Core process. These components connect through an interprocess communication framework. For details on these Visual Studio changes, visit .
For details on the .NET Core designer in Wisej.NET 4, visit:
Read below to understand how these changes affect your projects and potential issues to avoid:
Wisej.NET 4 incorporated comprehensive support for Fluent Markup syntax in both C# and VB.NET, enabling consistent coding across programming languages.
For an introduction to Wisej.Web.Markup extensions, visit:
We've added the AllowMarkdown property to complement AllowHtml. This property enables markdown text rendering across Wisej.NET controls - expanded text formatting options.
The new AddOrReplaceService method replaces a service without requiring prior removal.
All controls now include the ControlRendered and ControlUpdated events. This allows applications to modify control JSON rendering and handle browser updates without subclassing.
The updated file-scoped namespace declaration is now implemented across all .cs files. However, the transition to top-level statements is applied exclusively to the Startup.cs file. This modern approach simplifies the code structure, making it cleaner and easier to read.
Some Wisej.NET projects need changes in .resx (resource) and .Designer.cs (designer) files for Wisej.NET 4 and managed System.Drawing compatibility.
To facilitate this transition, we have provided an upgrade tool that automatically implements these changes across your project files.
For detailed instructions, visit:
Wisej.NET continues to support .NET Framework 4.8 (and newer) and VB.NET at both runtime and design time. As with all preceding versions, we will maintain this support for the foreseeable future.
To facilitate a smooth transition from Wisej.NET version 3.5 to version 4.0, we will continue to maintain the 3.5 branch by providing bug fixes and enhancements for at least one year following the initial stable release of version 4.0. This ensures ongoing support and stability for existing users during their upgrade process.
System.Drawing in .NET Framework and System.Drawing.Common In .NET Core wrap Windows GDI+, the graphics device interface is used to render graphics and load fonts on Windows. System.Drawing.Common extends to Linux using . Microsoft provides no graphic support in .NET Core for iOS or Android platforms.
In Wisej.NET 3.5, font loading used different libraries per platform. .NET Framework 4.8 used System.Drawing with Windows GDI+. .NET Core used System.Drawing.Common with on Linux. Wisej.NET Hybrid applications used an early System.Drawing reimplementation using for iOS and Android. This caused font measurement differences across platforms.
Microsoft introduced Fluent Markup extensions for .NET Multi-platform App UI (), which are documented at . These extensions streamline declarative UI development in code.
This enhancement came from Tim at , one of our Technology Partners.
Wisej.NET controls with labels include the property for HTML tags in text.
methods are now chainable, allowing concise syntax like Application.Services.AddService<Service1>().AddService<Service2>().
We now fully support HttpOnly cookies. Previously, developers could use cookies through the native . The Wisej.Base.Cookie class now includes a property for managing HttpOnly cookies.
These events enable to add AI capabilities to any Wisej.NET control.
All C# templates have been revised to incorporate the latest C# syntax enhancements, specifically utilizing and .