MySqlConnector 2.5.0

Prefix Reserved
.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. .NET Framework 4.6.2 This package targets .NET Framework 4.6.2. The package is compatible with this framework or higher. 
dotnet add package MySqlConnector --version 2.5.0
                    


                    

                
NuGet\Install-Package MySqlConnector -Version 2.5.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="MySqlConnector" Version="2.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="MySqlConnector" Version="2.5.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="MySqlConnector" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add MySqlConnector --version 2.5.0
                    


                    

                
#r "nuget: MySqlConnector, 2.5.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package MySqlConnector@2.5.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=MySqlConnector&version=2.5.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=MySqlConnector&version=2.5.0
                    


                            Install as a Cake Tool

About

MySqlConnector is a C# ADO.NET driver for MySQL, MariaDB, Amazon Aurora, Azure Database for MySQL and other MySQL-compatible databases.

More documentation is available at the MySqlConnector website.

How to Use

// set these values correctly for your database server
var builder = new MySqlConnectionStringBuilder
{
	Server = "your-server",
	UserID = "database-user",
	Password = "P@ssw0rd!",
	Database = "database-name",
};

// open a connection asynchronously
await using var connection = new MySqlConnection(builder.ConnectionString);
await connection.OpenAsync();

// create a DB command and set the SQL statement with parameters
await using var command = connection.CreateCommand();
command.CommandText = @"SELECT * FROM orders WHERE order_id = @OrderId;";
command.Parameters.AddWithValue("@OrderId", orderId);

// execute the command and read the results
await using var reader = await command.ExecuteReaderAsync();
while (reader.Read())
{
	var id = reader.GetInt32("order_id");
	var date = reader.GetDateTime("order_date");
	// ...
}

ASP.NET

For ASP.NET, use the MySqlConnector.DependencyInjection package to integrate with dependency injection and logging.

var builder = WebApplication.CreateBuilder(args);

// use AddMySqlDataSource to configure MySqlConnector
builder.Services.AddMySqlDataSource(builder.Configuration.GetConnectionString("Default"));

var app = builder.Build();

// use dependency injection to get a MySqlConnection in minimal APIs or in controllers
app.MapGet("/", async (MySqlConnection connection) =>
{
    // open and use the connection here
    await connection.OpenAsync();
    await using var command = connection.CreateCommand();
    command.CommandText = "SELECT name FROM users LIMIT 1";
    return "Hello World: " + await command.ExecuteScalarAsync();
});

app.Run();

Key Features

  • Full support for async I/O
  • High performance
  • Supports .NET Framework, .NET Core, and .NET 5.0+

Main Types

The main types provided by this library are:

  • MySqlConnection (implementation of DbConnection)
  • MySqlCommand (implementation of DbCommand)
  • MySqlDataReader (implementation of DbDataReader)
  • MySqlBulkCopy
  • MySqlBulkLoader
  • MySqlConnectionStringBuilder
  • MySqlConnectorFactory
  • MySqlDataAdapter
  • MySqlException
  • MySqlTransaction (implementation of DbTransaction)

Feedback

MySqlConnector is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 is compatible.  net472 was computed.  net48 is compatible.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (764)

Showing the top 5 NuGet packages that depend on MySqlConnector:

Package Downloads
Pomelo.EntityFrameworkCore.MySql

Pomelo's MySQL database provider for Entity Framework Core.
AspNetCore.HealthChecks.MySql

HealthChecks.MySql is the health check package for MySQL.
SqlSugarCore

.Net Core3.1 .Net5 .Net6 .Net7 .Net8 .Net9 .Net10 安装此版本，好用的ORM框架 ，支持国外主流和国产人大金仓达梦 OceanBase GaussDB QuestDb ClickHouse Oracle MySql Gbase8s SqlServer Sqlite DB2 DuckDb Hana 等， 使用教程：https://www.donet5.com/Home/Doc?typeId=1226
DistributedLock

Provides easy-to-use mutexes, reader-writer locks, and semaphores that can synchronize across processes and machines. This is an umbrella package that brings in the entire family of DistributedLock.* packages (e. g. DistributedLock.SqlServer) as references. Those packages can also be installed individually.
Hangfire.MySqlStorage

Hangfire MySql Storage

GitHub repositories (125)

Showing the top 20 popular GitHub repositories that depend on MySqlConnector:

Repository Stars
dotnet/aspnetcore
ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.
DapperLib/Dapper
Dapper - a simple object mapper for .Net
nopSolutions/nopCommerce
ASP.NET Core eCommerce software. nopCommerce is a free and open-source shopping cart.
TechnitiumSoftware/DnsServer
Technitium DNS Server
dotnetcore/CAP
Distributed transaction solution in micro-service base on eventually consistency, also an eventbus with Outbox pattern
quartznet/quartznet
Quartz Enterprise Scheduler .NET
DotNetNext/SqlSugar
.Net aot ORM SqlServer ORM Mongodb ORM MySql 瀚高 Postgresql ORM DB2 Hana 高斯 Duckdb C# VB.NET Sqlite ORM Oracle ORM Mysql Orm 虚谷数据库 达梦 ORM 人大金仓 ORM 神通ORM C# ORM , C# ORM .NET ORM NET9 ORM .NET8 ORM ClickHouse ORM QuestDb ,TDengine ORM,OceanBase ORM,GaussDB ORM,Tidb ORM Object/Relational Mapping
aspnet/Mvc
[Archived] ASP.NET Core MVC is a model view controller framework for building dynamic web sites with clean separation of concerns, including the merged MVC, Web API, and Web Pages w/ Razor. Project moved to https://github.com/aspnet/AspNetCore
ServiceStack/ServiceStack
Thoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
dotnetcore/Util
Util是一个.Net平台下的应用框架，旨在提升中小团队的开发能力，由工具类、分层架构基类、Ui组件，配套代码生成模板，权限等组成。
dotnetcore/FreeSql
.NET aot orm, VB.NET/C# orm, Mysql/PostgreSQL/SqlServer/Oracle orm, Sqlite/Firebird/Clickhouse/DuckDB orm, 达梦/金仓/虚谷/翰高/高斯 orm, 神通 orm, 南大通用 orm, 国产 orm, TDengine orm, QuestDB orm, MsAccess orm.
Xabaril/AspNetCore.Diagnostics.HealthChecks
Enterprise HealthChecks for ASP.NET Core Diagnostics Package
testcontainers/testcontainers-dotnet
A library to support tests with throwaway instances of Docker containers for all compatible .NET Standard versions.
dotnetcore/DotnetSpider
DotnetSpider, a .NET standard web crawling library. It is lightweight, efficient and fast high-level web crawling & scraping framework
ravendb/ravendb
ACID Document Database
fluentmigrator/fluentmigrator
Fluent migrations framework for .NET
linq2db/linq2db
Linq to database provider.
MiniProfiler/dotnet
A simple but effective mini-profiler for ASP.NET (and Core) websites
SciSharp/BotSharp
AI Multi-Agent Framework in .NET
FastReports/FastReport
Free Open Source Reporting tool for .NET6/.NET Core/.NET Framework that helps your application generate document-like reports
Version Downloads Last Updated
2.5.0 669,433 11/12/2025
2.4.0 8,898,285 11/12/2024
2.3.7 6,236,744 4/22/2024
2.3.6 801,546 3/20/2024
2.3.5 28,044,752 1/20/2024
2.3.4 403,789 1/14/2024
2.3.3 531,759 12/19/2023
2.3.2 113,936 12/18/2023
2.3.1 4,160,718 11/17/2023
2.3.0 496,487 11/14/2023
2.2.7 3,767,057 7/21/2023
2.2.6 2,225,227 5/4/2023
2.2.5 21,388,915 1/1/2023
2.2.4 216,189 12/23/2022
2.2.3 879,032 12/18/2022
2.2.2 896,010 12/6/2022
2.2.1 634,154 11/21/2022
2.2.0 1,074,972 11/8/2022
2.1.13 2,505,529 8/26/2022
2.1.12 287,757 8/12/2022
2.1.11 675,193 7/14/2022
2.1.10 2,766,469 6/4/2022
2.1.9 393,314 5/16/2022
2.1.8 1,492,781 3/7/2022
2.1.7 434,727 2/20/2022
2.1.6 188,974 2/10/2022
2.1.5 384,634 1/30/2022
2.1.4 214,428 1/25/2022
2.1.3 106,442 1/25/2022 2.1.3 is deprecated because it has critical bugs.
2.1.2 24,022,120 12/23/2021
2.1.1 108,365 12/21/2021
2.1.0 2,188,911 11/28/2021
2.0.0 7,117,100 11/9/2021
1.3.14 1,465,264 10/20/2021
1.3.13 3,909,058 10/2/2021
1.3.12 389,108 9/11/2021
1.3.11 3,150,268 7/2/2021
1.3.10 2,825,415 6/16/2021
1.3.9 736,762 5/27/2021 1.3.9 is deprecated because it has critical bugs.
1.3.8 501,461 4/30/2021 1.3.8 is deprecated because it has critical bugs.
1.3.7 2,212,182 4/24/2021 1.3.7 is deprecated because it has critical bugs.
1.3.6 100,915 4/24/2021 1.3.6 is deprecated because it has critical bugs.
1.3.5 105,792 4/23/2021 1.3.5 is deprecated because it has critical bugs.
1.3.4 246,122 4/21/2021 1.3.4 is deprecated because it has critical bugs.
1.3.3 260,473 4/12/2021 1.3.3 is deprecated because it has critical bugs.
1.3.2 989,023 3/22/2021 1.3.2 is deprecated because it has critical bugs.
1.3.1 309,954 3/11/2021 1.3.1 is deprecated because it has critical bugs.
1.3.0 331,099 3/7/2021 1.3.0 is deprecated because it has critical bugs.
1.2.1 1,494,712 12/12/2020
1.2.0 510,464 11/26/2020
1.1.0 3,009,512 11/10/2020
1.0.1 2,648,321 8/13/2020
1.0.0 3,781,611 7/11/2020
0.69.10 2,639,963 10/21/2020
0.69.9 4,439,875 8/20/2020
0.69.8 232,498 7/20/2020
0.69.7 107,218 7/16/2020
0.69.6 242,909 7/7/2020
0.69.5 184,369 7/1/2020
0.69.4 132,951 6/25/2020
0.69.3 293,264 6/16/2020
0.69.2 118,508 6/12/2020
0.69.1 106,984 6/10/2020
0.69.0 118,684 6/8/2020
0.68.1 103,833 6/8/2020
0.68.0 101,383 6/6/2020
0.67.0 168,513 5/30/2020
0.66.0 484,267 5/7/2020
0.65.0 128,351 5/3/2020
0.64.2 133,703 4/28/2020
0.64.1 128,158 4/26/2020
0.64.0 152,356 4/18/2020
0.63.2 353,642 4/9/2020
0.63.1 432,851 4/4/2020
0.63.0 148,892 3/26/2020
0.62.0 574,754 2/29/2020
0.61.0 8,490,296 11/5/2019
0.60.4 114,782 11/4/2019
0.60.3 520,670 10/28/2019
0.60.2 303,464 10/21/2019
0.60.1 104,209 10/20/2019
0.60.0 114,762 10/19/2019
0.59.2 1,983,311 10/4/2019
0.59.1 114,885 9/30/2019
0.59.0 138,296 9/25/2019
0.58.0 163,239 9/24/2019
0.57.0 105,476 9/23/2019
0.56.0 2,681,968 5/26/2019
0.55.0 133,258 5/24/2019
0.54.0 171,140 5/11/2019
0.53.0 280,815 4/19/2019
0.52.0 254,878 4/11/2019
0.51.1 225,007 3/27/2019
0.51.0 105,784 3/27/2019
0.50.0 144,073 3/18/2019
0.49.3 300,190 1/24/2019
0.49.2 4,929,204 1/16/2019
0.49.0 106,075 1/12/2019
0.48.2 231,189 12/12/2018
0.48.1 106,242 12/10/2018
0.48.0 116,610 12/8/2018
0.47.1 3,515,506 11/4/2018
0.47.0 102,830 11/3/2018
0.46.2 115,827 10/25/2018
0.46.1 209,010 10/16/2018
0.46.0 110,590 10/12/2018
0.45.1 1,027,292 9/29/2018
0.45.0 132,069 9/13/2018
0.44.1 1,437,136 8/24/2018
0.44.0 107,013 8/21/2018
0.43.0 224,079 7/27/2018
0.42.3 148,399 7/6/2018
0.42.2 190,668 6/30/2018
0.42.1 1,127,549 6/16/2018
0.42.0 116,964 6/9/2018
0.41.0 103,673 6/8/2018
0.40.4 1,047,105 5/19/2018
0.40.3 169,205 4/26/2018
0.40.2 123,895 4/19/2018
0.36.0 149,857 2/16/2018
0.35.0 180,695 1/21/2018
0.32.0 1,163,066 11/24/2017
0.30.0 201,277 10/31/2017
0.29.4 124,378 10/31/2017
0.29.2 168,023 10/26/2017
0.26.5 133,440 9/22/2017
0.26.4 462,977 9/13/2017
0.26.3 102,316 9/13/2017
0.26.2 150,796 9/7/2017
0.26.1 127,641 9/3/2017
0.26.0 136,205 8/25/2017
0.25.1 200,391 8/17/2017
0.25.0 133,040 8/13/2017
0.20.0 103,871 6/1/2017
0.19.5 113,445 5/26/2017
0.19.4 103,842 5/13/2017
0.19.3 102,928 5/11/2017
0.19.2 3,382,908 5/1/2017
0.16.2 128,833 4/2/2017
0.10.0 111,685 12/29/2016
0.9.0 104,556 12/13/2016
0.8.0 105,670 12/7/2016
0.7.4 103,418 12/7/2016
0.7.3 162,874 11/28/2016
0.7.2 116,663 11/23/2016
0.7.1 108,199 11/21/2016
0.7.0 106,339 11/13/2016
0.6.2 126,008 10/28/2016
0.6.1 103,884 10/27/2016
0.6.0 103,512 10/23/2016
0.5.0 104,126 10/20/2016
0.4.0 105,156 10/13/2016
0.3.0 103,608 10/12/2016
0.2.1 103,313 10/10/2016
0.2.0 103,443 10/9/2016
0.1.0 125,319 10/4/2016

https://mysqlconnector.net/overview/version-history/