Upgrade from 3.x

Previously, upgrading to Wisej.NET 4 involved a complex process that required replacing instances of System.Drawing.Bitmap with Wisej.Base.ResourceImage. However, with the latest build, the requirement to use Wisej.Base.ResourceImage has been eliminated and the class has been removed. This update simplifies the upgrade process and enhances ease of development, making it more straightforward for developers to transition to the latest version.

Overview

Transitioning to Wisej.NET 4 and the .NET Core Designer requires replacing these two classes:

System.Resources.ResourceManager ⇒ Wisej.Resources.ResourceManager
System.ComponentModel.ComponentResourceManager ⇒ Wisej.Resources.ComponentResourceManager

The rationale behind this change is that the implementation of System.Resources.ResourceManager in .NET loads the specific type specified in the resources file without providing a way to override its behvior. Consequently, when dealing with embedded images, this approach fails on Linux systems without the installation of libgdiplus, and it is inherently incompatible with iOS and Android devices, resulting in failure on those platforms as well.

Our re-implementation maintains full compatibility with all existing resources and is flexible enough to adapt to the target platform seamlessly. On Windows, it utilizes System.Drawing (GDI+), while on all other platforms, it leverages our newly developed System.Drawing.Managed, which is based on ImageSharp.

The new Wisej.Resources.ResourceManager is available in Wisej.NET starting with build 3.5.18 to ensure backward compatibility from 4.0.

The replacement is necessary solely for managing embedded images. Generally, you will notice extensive use of the ResourceManager in all .Designer.cs and .Designer.vb files.

ResXFileCodeGenerator

Since the .Designer.cs or .Designer.vb file associated with a project's resources is automatically generated by Visual Studio using the ResXFileCodeGenerator tool, we have replaced it to ensure that the generated code utilizes the updated types introduced with Wisej.NET 4.

If you target only .NET Framework, these changes don't apply to you.

Upgrade Tool

The Upgrade Tool is designed to automate the migration of .Designer.cs/vb files by replacing the ResourceManager references.

The tool applies the following modifications:

ComponentResourceManager Replaces all references to System.ComponentModel.ComponentResourceManager to Wisej.Resources.ComponentResourceManager. These are commonly found nested under the project's .resx files.
ResourceManager
- Replaces all references to System.Resources.ResourceManager to Wisej.Resources.ResourceManager. These are commonly found in the designer files related to visual components.

PreviousMarkdown Support NextReleases

Last updated 5 days ago

Was this helpful?

Overview

Transitioning to Wisej.NET 4 and the .NET Core Designer requires replacing these two classes:

System.Resources.ResourceManager ⇒ Wisej.Resources.ResourceManager

System.ComponentModel.ComponentResourceManager ⇒ Wisej.Resources.ComponentResourceManager

The new Wisej.Resources.ResourceManager is available in Wisej.NET starting with build 3.5.18 to ensure backward compatibility from 4.0.

The replacement is necessary solely for managing embedded images. Generally, you will notice extensive use of the ResourceManager in all .Designer.cs and .Designer.vb files.

ResXFileCodeGenerator

If you target only .NET Framework, these changes don't apply to you.

Upgrade Tool

The Upgrade Tool is designed to automate the migration of .Designer.cs/vb files by replacing the ResourceManager references.

The tool applies the following modifications:

ComponentResourceManager Replaces all references to System.ComponentModel.ComponentResourceManager to Wisej.Resources.ComponentResourceManager. These are commonly found nested under the project's .resx files.

ResourceManager

Replaces all references to System.Resources.ResourceManager to Wisej.Resources.ResourceManager. These are commonly found in the designer files related to visual components.