Referencing .NET Core Assemblies

SocketTools 10 includes assemblies which target .NET Core 3.1, .NET 5.0 and .NET 6.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.

Important: .NET 5.0 reaches end-of-support on May 8, 2022 and .NET Core 3.1 reaches end-of-support on December 3, 2022. It is recommended you upgrade your projects to .NET 6.0 which is a Long Term Support (LTS) release.

To use either .NET Core 3.1, 5.0 or 6.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\core3.1
C:\Program Files (x86)\Common Files\SocketTools\10.0\Assemblies\v5.0
C:\Program Files (x86)\Common Files\SocketTools\10.0\Assemblies\v6.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 was a Long Term Support (LTS) release, meaning Microsoft committed to supporting it for 3 years after its release. They announced support for .NET Core 2.1 ended in August, 2021 and will no longer receive updates after that time.

In practical terms, this means that future versions of SocketTools will only include .NET Core 2.1 assemblies for use with legacy applications. We recommend you update your .NET Core projects to use .NET 5.0 or .NET 6.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 merged 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 which includes the .NET 5.0 Runtime.

.NET 6.0

.NET 6.0 is the latest version of the .NET Framework and was released on November 8, 2021. To use .NET 6.0 with your projects, you will need to use the current version of Visual Studio 2022 which includes the .NET 6.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 6.0 as the default used with Visual Studio 2022.


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

 Download .NET Core 3.1
 Download .NET 5.0
 Download .NET 6.0

See Also

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