README.md

MySQL Connector/NET

MySQL provides connectivity for client applications developed in .NET compatible programming languages with Connector/NET.

MySQL Connector/NET is a library compatible with .NET Framework and .NET Core, for specific versions see MySQL Connector/NET Versions. The driver is a pure C# implementation of the MySQL protocol and does not rely on the MySQL client library.

From MySQL Connector/NET 8.0, the driver also contains an implementation of MySQL X DevAPI, an Application Programming Interface for working with MySQL as a Document Store through CRUD-based, NoSQL operations.

From MySQL Connector/NET 8.1, the driver contains an implementation of OpenTelemetry which requires the use of the MySql.Data.OpenTelemetry Nuget package to enable the generation of telemetry data.

From MySQL Connector/NET 8.2, the driver adds support for WebAuthn authentication, the driver also adds support for .NET 8.

From MySQL Connector/NET 8.3, the driver also adds support for .NET 8 and EFCore 8 GA versions.

From MySQL Connector/NET 8.4, the driver adds support for TLS1.3 and removes support for FIDO authentication plugin.

From MySQL Connector/NET 9.0, the driver removes support for .NET 7 and EF Core 7.

From MySQL Connector/NET 9.1, the driver adds support for .NET 9 and EF Core 9 preview versions.

For detailed information please visit the official MySQL Connector/NET documentation.

Licensing

Please refer to files README and LICENSE, available in this repository, and Legal Notices in documentation for further details.

Security

Oracle values the independent security research community and believes that responsible disclosure of security vulnerabilities helps us ensure the security and privacy of all our users. Please refer to the security guidelines document for additional information.

Download & Install

MySQL Connector/NET can be installed from precompiled libraries by using MySQL installer or download the libraries itself, both can be found at Connector/NET download page. Also, you can get the latest stable release from the official Nuget.org feed.

• By using MySQL Installer, you just need to follow the wizard in order to obtain the precompiled library and then add it to your project.
• If you decided to download the precompiled libraries, decompress the folder and then add the library needed to your project as a reference.
• If you go for NuGet, you could use the NuGet Package Manager inside Visual Studio or use the NuGet Command Line Interface (CLI).

Building from sources

This driver can also be complied and installed from the sources available in this repository. Please refer to the documentation for detailed instructions on how to do it.

Github Repository

This repository contains the MySQL Connector/NET source code as per latest released version. You should expect to see the same content here and within the latest released Connector/NET package.

Contributing

We greatly appreciate feedback from our users, including bug reports and code contributions. Your input helps us improve, and we thank you for any issues you report or code you contribute. Please refer to the contributing guidelines document for additional information.

Additional Resources

• MySQL Connector/NET Developer Guide
• MySQL Connector/NET API
• MySQL NuGet
• MySQL Connector/NET and C#, Mono, .Net Forum
• #connectors channel on MySQL Community Slack (Sign-up required if you do not have an Oracle account.)
• @MySQL on X.
• MySQL Blog.
• MySQL Connectors Blog archive.
• MySQL Newsletter.
• MySQL Bugs Tracking System.

For more information about this and other MySQL products, please visit MySQL Contact & Questions.