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.ResourceManagerSystem.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 ResourceManager will be included in a future update of Wisej.NET 3.5 to ensure backward compatibility.
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.
Update 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.ComponentResourceManagertoWisej.Resources.ComponentResourceManager. These are commonly found nested under the project's .resx files.ResourceManager
Replaces all references to
System.Resources.ResourceManagertoWisej.Resources.ResourceManager. These are commonly found in the designer files related to visual components.
Last updated
Was this helpful?
