Referencing .NET Core and .NET 5.0 Assemblies

SocketTools 10 includes assemblies which target .NET Core 2.1, .NET Core 3.1 and .NET 5.0. They are available as part of the standard installation package; however, those assemblies will not be shown as the default for new projects, you will need to explicitly reference them.

To use either .NET Core 2.1, 3.1 or 5.0 with your project, you will need to add a reference to your project selecting ProjectAdd Project Reference from the menu and then clicking the Browse button. Then browse to the folder which contains the SocketTools assemblies you want to reference:

C:\Program Files (x86)\Common Files\SocketTools\10.0\Assemblies\core2.1
C:\Program Files (x86)\Common Files\SocketTools\10.0\Assemblies\core3.1
C:\Program Files (x86)\Common Files\SocketTools\10.0\Assemblies\v5.0

After you've selected the assembly, it will be included in the list of recently added references. In this example, the project is referencing the SocketTools.HttpClient class in version 10.

Visual Studio 2019 Reference Manager

Returning to the Solution Explorer, you can select the assembly (under Dependencies) and then set the appropriate properties for your project. For example, if you want a local copy of the assembly.

.NET Core 2.1

.NET Core 2.1 is a Long Term Support (LTS) release, meaning Microsoft committed to supporting it for 3 years after its release. They have announced support for .NET Core 2.1 will end in August, 2021 and will no longer receive updates after that time.

In practical terms, this means that future versions of SocketTools will only provide these assemblies for use with legacy applications. The .NET Core 2.1 assemblies will be included with other legacy assemblies, such as those for .NET 2.0. We recommend you update your .NET Core projects to use .NET 5.0 when possible.

The support lifecycle for .NET can be complicated because some of the .NET Framework versions are tied to support for the operating system. For more information, you can review the .NET Framework Lifecycle FAQ.

.NET 5.0

.NET 5.0 is the newest general release of the .NET Framework. It was effectively a merge between the .NET 4.8 Framework and .NET Core 3.1, with additional functionality. To use .NET 5.0 with your projects, you will need to use the latest version Visual Studio 2019 and download the .NET 5.0 Runtime.

The installer for SocketTools 10 still defaults to selecting the .NET 4.5 assemblies, which are compatible with versions 4.5 through 4.8. In future updates for SocketTools, we will set .NET 5.0 as the default used with Visual Studio 2019.

Download

If you do not have the current version of .NET Core or .NET 5.0 installed on your development system, you can download them from Microsoft using the links below.

 Download .NET Core 2.1
 Download .NET Core 3.1
 Download .NET 5.0

See Also

Reference Manager Lists Multiple Assemblies
Supported Versions of Visual Studio
SocketTools .NET 6.0 Framework Preview