Releases
Every Wisej.NET release since 2.0 has a page here describing what it added, what it changed, and what an existing project has to do to move to it. Read the notes for each version between the one you are on and the one you are moving to: the upgrade steps are cumulative, and the .NET targets a version supports are listed with it. Statements about experimental features and planned work reflect the release they were written for.
The current release is 4.1; its notes are under What's New in 4.1.
Version History
| Version | .NET targets | Headline |
|---|---|---|
| 4.1 | .NET Framework 4.8, .NET 8+ | Accessibility, Fluent themes and icon packs, ChartJS4 and Mermaid extensions |
| 4.0 | .NET Framework 4.8, .NET 8+ | .NET Core designer, managed graphics, Fluent Markup, Markdown |
| 3.5 | .NET Framework 4.8, .NET 7 | Wisej.NET Hybrid for iOS, Android and macOS |
| 3.2 | .NET Framework 4.8, .NET 6+ | Validation rules, JSON View Builder, private fonts |
| 3.1 | .NET Framework 4.8, .NET 6+ | Visual Studio Marketplace installer, dependency injection, commanding |
| 3.0 | .NET Framework 4.8, .NET 6 | First release to run on .NET Core — Windows, Linux and macOS |
| 2.5 | .NET Framework 4.8 | Edge designer, NuGet deployment, DataGridView summary and frozen rows |
| 2.2 | .NET Framework | PWA support, native iOS and Android integration, virtual rows |
| 2.1 | .NET Framework | DataRepeater, editor labels, writable themes |
| 2.0 | .NET Framework | Modernized designer, responsive properties, Brotli |
What's New in 4.1
A feature release on the 4.0 foundation. Every control now emits ARIA roles and state for screen readers and browser automation; four Fluent and Material themes and three icon packs (FluentUI Filled, FluentUI Outlined, Lucide) join the built-in set; and two extensions arrive, ChartJS4 for Chart.js 4 and Mermaid for text-defined diagrams. One breaking change: AccessibleRole was removed.
What's New in 4.0
The release that made Wisej.NET independent of the .NET Framework at design time. A new out-of-process .NET Core designer runs beside the .NET Framework one, so a project can target net8.0-windows;net8.0 with no net48 at all. Managed graphics — System.Drawing.Managed, built with SixLabors on ImageSharp — replaces GDI+ and libgdiplus for font measurement and image loading, giving the same layout on Windows, Linux, macOS, iOS and Android. Fluent Markup declares a UI in chained C# calls, and Markdown joins HTML as a text format on every control that has AllowHtml.
Upgrading from 3.x needs the resource-manager change in .Designer.cs files, which the upgrade tool applies.
What's New in 3.5
Wisej.NET Hybrid: the same application runs on iOS, Android and macOS inside a .NET MAUI shell with an embedded server, online or fully offline, with three new project templates. The framework moves to .NET 7, every control gains constructors with optional arguments and chainable methods, and the BootstrapDark-4 theme, the Chat, Signature, Pull-to-Refresh and TesseractJS extensions, and the Dynamsoft and Mobiscroll premium extensions arrive.
What's New in 3.2
Enterprise features for line-of-business applications: a Validation extender with built-in and custom rules and pluggable error providers, the experimental JSON View Builder for building views from a model, private fonts deployed with the application instead of installed on the server, an HTTPS option in the project wizard, a design-time debug mode for the Edge renderers, and the DevExpress Dashboard premium extension.
What's New in 3.1
Wisej.NET moves to the Visual Studio Marketplace as a VSIX, with templates and designer registered without the GAC. Dependency injection and commanding, experimental in 3.0, become fully supported; data binding gains ObservableCollection<>; the TypedTextBox editor, a horizontal ListBox, F1 integrated help, "tiny tool" icons in the property grid, the WebAuthn extension, and the Application.OpenWindow callback arrive.
What's New in 3.0
The first Wisej.NET that runs on .NET Core. One code base targets .NET Framework 4.8 and .NET 6 and deploys on Windows, Linux and macOS as a standard ASP.NET Core application. That brings the SDK project format, multi-targeting, Docker support and Kestrel, and the release notes carry the guide for converting an existing project. New in the framework: download callbacks, LayoutChildren, experimental commanding and a service container, and DataGridView.DataRead for server-side caching in virtual mode.
What's New in 2.5
The last release for .NET Framework alone, and the one that prepared for 3.0: Wisej.NET is deployed as a NuGet package from here on rather than copied into Program Files. The designer and the Theme Builder render with Edge/Chromium, the DataGridView gains summary rows and frozen rows, and a Bootstrap theme and icon pack are added.
What's New in 2.2
Built-in PWA support with offline pages, native iOS and Android integration for Technology Partners, virtual rows in the DataGridView that cut memory for large data sets by an order of magnitude, the Toast notification, Fill and Append on every data-bound control, data binding for the ListView, and the dynamic Widget.Instance for driving third-party JavaScript libraries.
What's New in 2.1
The DataRepeater container, a responsive Label on every editor, the TimeUpDown editor, the Shape control, the TabOrderManager extender, weak static events on Application, prefetching for virtual lists, infinite sessions, impersonation, sounds, and themes that can be modified at run time.
What's New in 2.0
A modernized designer with snap lines, a document outline and responsive properties; client-side properties, methods and events on every control (CssClass, CssStyle, States, ClientEvents, InitScript); Brotli compression; enhanced load balancing; and theme settings and stylesheet rules.
Upgrade from 1.x
The checklist for bringing a Wisej.NET 1.x project forward: target .NET Framework 4.8, replace the Wisej.Web and Wisej.Core assembly references with the NuGet package, and rename the namespaces in .resx files, designer code and Web.config.