Unsupported IRISClient Assemblies
InterSystems IRIS has dropped support for several versions of .NET that are no longer in support by Microsoft (.NET Framework 2.0, 4.0 and 4.5, and .NET Core 1.0 and 2.1). Older projects that use the path to the dll location will need to update the path to correspond to the new assembly file location. For example, a previous path would be:
\<IRIS install location>\dev\dotnet\bin\v4.5\InterSystems.Data.IRISClient.dll
That location will no longer exist under the new installation, and should be changed to:
\<IRIS install location>\dev\dotnet\bin\v4.6.2\InterSystems.Data.IRISClient.dll
In terms of compatibility between versions, the newer 4.6.2 version is backwards compatible and the applications will run on systems that have any .NET Framework 4.x installed.
However, .NET Framework is not forwards-compatible, so if your application targets .NET Framework 4.5 specifically, it cannot use .NET Framework 4.6.2 client libraries as a dependency. In this case, your options are:
-
Change the target framework of the application to be at least 4.6.2. .NET Framework 4.5 has been out of support by Microsoft since 2016, so this will also ensure users are using a supported language version.
-
Use the .NET Framework 3.5 version of the library. You may lose access to certain features or functionality introduced in version 4.0.
-
Continue to use an older version of the client library that targets 4.5. Older versions will not contain the latest bug fixes or functionality, but you will not need to modify the dependencies of your application. This is a temporary solution, since upgrades to future versions the InterSystems IRIS server will eventually make them incompatible with the older clients.