MySQL Connector/NET Developer Guide

Chapter 2 Connector/NET Versions

There are two Connector/NET release series described in this guide:

Secure connections using the TLSv1.2 protocol require Connector/NET 8.0.11 or later. In addition, your Microsoft Windows host must have the TLSv1.2 protocol enabled. Connections made using Windows named pipes or shared memory do not support the TLSv1.2 protocol. For general guidance about configuring the server and clients for secure connections, see Configuring MySQL to Use Encrypted Connections.

Note

.NET 5.0, .NET Core 3.1, and .NET Framework 4.8 (Windows only) include support for the TLSv1.3 protocol. Be sure to confirm that the operating system running your application also supports TLSv1.3 before using it exclusively for connections.

The following table shows the versions of ADO.NET, .NET (Core and Framework), and MySQL Server that are supported or required by MySQL Connector/NET.

Table 2.1 Connector/NET Requirements for Related Products

Connector/NET Version ADO.NET Version .NET Version Required MySQL Server Supported?
8.0 2.x+
  • C/NET 8.0.23+: .NET 5.0 for VS 2019 (v16.8) and VS 2019 for Mac (v8.8); .NET Core 3.1 for VS 2019 (version 16.4 or later); .NET Framework 4.8 for VS 2019 (version 16.3 or later)

  • C/NET 8.0.22+: .NET 5.0 for VS 2019 (v16.7) and VS 2019 for Mac (v8.7); .NET Core 3.1 for VS 2019 (version 16.4 or later); .NET Framework 4.8 for VS 2019 (version 16.3 or later)

  • C/NET 8.0.20+: .NET Core 3.1 for VS 2019 (version 16.4 or later); .NET Framework 4.8 for VS 2019 (version 16.3 or later)

  • C/NET 8.0.19+: .NET Core 3.0 for VS 2019 (version 16.3 or later); .NET Framework 4.8 for VS 2019 (version 16.3 or later)

  • C/NET 8.0.18+: .NET Core 3.0 for VS 2019 (version 16.3 or later)

  • C/NET 8.0.17+: .NET Core 2.2 for VS 2017 (version 15.0.9 or later), .NET Core 2.1 for VS 2017 (version 15.0.7 or later)

  • C/NET 8.0.10+: .NET Core 2.0 for VS 2017 (version 15.0.3 or later)

  • C/NET 8.0.8+: .NET Framework 4.5.x for VS 2013 / 2015 / 2017

8.0, 5.7, 5.6 Yes
6.10 archived version 2.x+
  • C/NET 6.10.9+: .NET Core 2.2 for VS 2017 (version 15.0.9 or later), .NET Core 2.1 for VS 2017 (version 15.0.7 or later)

  • C/NET 6.10.5+: .NET Core 2.0 for VS 2017 (version 15.0.3 or later)

8.0, 5.7, 5.6 Upgrade to 8.0

The following versions of Connector/NET are no longer supported:

The following table shows the .NET Framework version required and the MySQL server version supported by Connector/NET:

Table 2.2 Connector/NET Requirements for Related Products

Connector/NET Version ADO.NET Version Supported .NET Framework Version Required MySQL Server Version Supported Currently Supported
7.0 2.x+ .NET Core 1.1 for VS 2015 / 2017; .NET Framework 4.5.x for VS 2013 / 2015 / 2017 5.7, 5.6 No
6.9 2.x+ 3.5+ for VS 2008, 4.x+ for VS 2010 / 2012 / 2013, WinRT for VS 2012 / 2013 5.7, 5.6, 5.5 No
6.8 2.x+ 3.5+ for VS 2008, 4.x+ for VS 2010 / 2012 / 2013, WinRT for VS 2012 / 2013 5.7, 5.6, 5.5, 5.1, 5.0 No
6.7 2.x+ 2.x+ for VS 2008, 4.x+ for VS 2010 / 2012 / 2013, WinRT for VS 2012 / 2013 5.7, 5.6, 5.5, 5.1, 5.0 No
6.6 2.x+ 2.x+ for VS 2008, 4.x+ for VS 2010 / 2012 / 2013 5.7, 5.6, 5.5, 5.1, 5.0 No
6.5 2.x+ 2.x+ for VS 2008, 4.x+ for VS 2010 5.7, 5.6, 5.5, 5.1, 5.0 No
6.4 2.x+ 2.x+, 4.x+ for VS 2010 5.6, 5.5, 5.1, 5.0 No
6.3 2.x+ 2.x+, 4.x+ for VS 2010 5.6, 5.5, 5.1, 5.0 No
6.2 2.x+ 2.x+ 5.6, 5.5, 5.1, 5.0, 4.1 No
6.1 2.x+ 2.x+ 5.6, 5.5, 5.1, 5.0, 4.1 No
6.0 2.x+ 2.x+ 5.5, 5.1, 5.0, 4.1 No
5.2 2.x+ 2.x+ 5.5, 5.1, 5.0, 4.1 No
5.1 2.x+ 2.x+ 5.5, 5.1, 5.0, 4.1, 4.0 No
5.0 2.x+ 2.x+ 5.0, 4.1, 4.0 No
1.0 1.x 1.x 5.0, 4.1, 4.0 No