MySqlConnector 2.3.4

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package MySqlConnector --version 2.3.4                
NuGet\Install-Package MySqlConnector -Version 2.3.4                
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.3.4" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MySqlConnector --version 2.3.4                
#r "nuget: MySqlConnector, 2.3.4"                
#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.
// Install MySqlConnector as a Cake Addin
#addin nuget:?package=MySqlConnector&version=2.3.4

// Install MySqlConnector as a Cake Tool
#tool nuget:?package=MySqlConnector&version=2.3.4                

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
using var connection = new MySqlConnection(builder.ConnectionString);
await connection.OpenAsync();

// create a DB command and set the SQL statement with parameters
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
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 is compatible.  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. 
.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 (597)

Showing the top 5 NuGet packages that depend on MySqlConnector:

Package Downloads
Pomelo.EntityFrameworkCore.MySql

Pomelo's MySQL database provider for Entity Framework Core.

SqlSugarCore

.Net Core3.1 .Net5 .Net6 .Net7 .Net8 安装此版本,好用的ORM框架 ,支持国外主流和国产人大金仓达梦 OceanBase GaussDB QuestDb ClickHouse Oracle MySql Gbase8s SqlServer Sqlite 等, 使用教程: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.

AspNetCore.HealthChecks.MySql

HealthChecks.MySql is the health check package for MySQL.

Hangfire.MySqlStorage

Hangfire MySql Storage

GitHub repositories (122)

Showing the top 5 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.
dotnetcore/CAP
Distributed transaction solution in micro-service base on eventually consistency, also an eventbus with Outbox pattern
quartznet/quartznet
Quartz Enterprise Scheduler .NET
Version Downloads Last updated
2.4.0 18,452 11/12/2024
2.4.0-beta.2 1,314 10/20/2024
2.4.0-beta.1 717 10/14/2024
2.3.7 2,272,659 4/22/2024
2.3.6 425,941 3/20/2024
2.3.5 6,826,351 1/20/2024
2.3.4 227,205 1/14/2024
2.3.3 261,050 12/19/2023
2.3.2 11,260 12/18/2023
2.3.1 1,472,772 11/17/2023
2.3.0 140,127 11/14/2023
2.2.7 2,233,907 7/21/2023
2.2.6 1,491,176 5/4/2023
2.2.5 14,316,888 1/1/2023
2.2.4 102,642 12/23/2022
2.2.3 589,909 12/18/2022
2.2.2 686,812 12/6/2022
2.2.1 434,075 11/21/2022
2.2.0 797,006 11/8/2022
2.1.13 1,781,793 8/26/2022
2.1.12 152,794 8/12/2022
2.1.11 519,714 7/14/2022
2.1.10 1,572,697 6/4/2022
2.1.9 249,888 5/16/2022
2.1.8 1,096,531 3/7/2022
2.1.7 299,479 2/20/2022
2.1.6 87,226 2/10/2022
2.1.5 257,011 1/30/2022
2.1.4 105,917 1/25/2022
2.1.3 8,302 1/25/2022 2.1.3 is deprecated because it has critical bugs.
2.1.2 20,227,495 12/23/2021
2.1.1 10,825 12/21/2021
2.1.0 1,331,621 11/28/2021
2.0.0 5,504,146 11/9/2021
1.3.14 1,111,791 10/20/2021
1.3.13 3,118,091 10/2/2021
1.3.12 279,426 9/11/2021
1.3.11 2,480,399 7/2/2021
1.3.10 2,508,324 6/16/2021
1.3.9 596,669 5/27/2021 1.3.9 is deprecated because it has critical bugs.
1.3.8 389,859 4/30/2021 1.3.8 is deprecated because it has critical bugs.
1.3.7 1,920,106 4/24/2021 1.3.7 is deprecated because it has critical bugs.
1.3.6 3,703 4/24/2021 1.3.6 is deprecated because it has critical bugs.
1.3.5 8,756 4/23/2021 1.3.5 is deprecated because it has critical bugs.
1.3.4 126,844 4/21/2021 1.3.4 is deprecated because it has critical bugs.
1.3.3 153,792 4/12/2021 1.3.3 is deprecated because it has critical bugs.
1.3.2 658,498 3/22/2021 1.3.2 is deprecated because it has critical bugs.
1.3.1 189,443 3/11/2021 1.3.1 is deprecated because it has critical bugs.
1.3.0 206,255 3/7/2021 1.3.0 is deprecated because it has critical bugs.
1.2.1 1,190,782 12/12/2020
1.2.0 388,363 11/26/2020
1.1.0 2,669,834 11/10/2020
1.0.1 2,099,169 8/13/2020
1.0.0 2,461,422 7/11/2020
0.69.10 2,293,672 10/21/2020
0.69.9 4,134,546 8/20/2020
0.69.8 130,240 7/20/2020
0.69.7 6,176 7/16/2020
0.69.6 145,902 7/7/2020
0.69.5 82,614 7/1/2020
0.69.4 33,677 6/25/2020
0.69.3 189,554 6/16/2020
0.69.2 20,270 6/12/2020
0.69.1 9,876 6/10/2020
0.69.0 19,430 6/8/2020
0.68.1 6,526 6/8/2020
0.68.0 4,518 6/6/2020
0.67.0 68,854 5/30/2020
0.66.0 375,108 5/7/2020
0.65.0 30,369 5/3/2020
0.64.2 35,242 4/28/2020
0.64.1 30,260 4/26/2020
0.64.0 52,496 4/18/2020
0.63.2 246,228 4/9/2020
0.63.1 315,044 4/4/2020
0.63.0 49,404 3/26/2020
0.62.0 313,298 2/29/2020
0.61.0 7,871,834 11/5/2019
0.60.4 17,983 11/4/2019
0.60.3 358,331 10/28/2019
0.60.2 192,852 10/21/2019
0.60.1 7,389 10/20/2019
0.60.0 16,552 10/19/2019
0.59.2 1,808,563 10/4/2019
0.59.1 17,422 9/30/2019
0.59.0 30,114 9/25/2019
0.58.0 62,109 9/24/2019
0.57.0 8,625 9/23/2019
0.56.0 2,422,861 5/26/2019
0.55.0 36,285 5/24/2019
0.54.0 70,028 5/11/2019
0.53.0 170,239 4/19/2019
0.52.0 150,225 4/11/2019
0.51.1 124,651 3/27/2019
0.51.0 9,087 3/27/2019
0.50.0 45,040 3/18/2019
0.49.3 200,125 1/24/2019
0.49.2 4,664,028 1/16/2019
0.49.0 9,217 1/12/2019
0.48.2 130,811 12/12/2018
0.48.1 9,374 12/10/2018
0.48.0 19,746 12/8/2018
0.47.1 3,306,424 11/4/2018
0.47.0 6,092 11/3/2018
0.46.2 18,541 10/25/2018
0.46.1 108,026 10/16/2018
0.46.0 13,623 10/12/2018
0.45.1 833,236 9/29/2018
0.45.0 33,293 9/13/2018
0.44.1 1,302,459 8/24/2018
0.44.0 10,237 8/21/2018
0.43.0 125,753 7/27/2018
0.42.3 50,444 7/6/2018
0.42.2 92,020 6/30/2018
0.42.1 995,945 6/16/2018
0.42.0 19,400 6/9/2018
0.41.0 6,319 6/8/2018
0.40.4 895,050 5/19/2018
0.40.3 70,861 4/26/2018
0.40.2 26,136 4/19/2018
0.36.0 49,509 2/16/2018
0.35.0 73,409 1/21/2018
0.32.0 1,012,571 11/24/2017
0.30.0 94,258 10/31/2017
0.29.4 27,140 10/31/2017
0.29.2 67,717 10/26/2017
0.26.5 33,370 9/22/2017
0.26.4 347,919 9/13/2017
0.26.3 5,205 9/13/2017
0.26.2 52,673 9/7/2017
0.26.1 30,052 9/3/2017
0.26.0 38,314 8/25/2017
0.25.1 102,151 8/17/2017
0.25.0 34,325 8/13/2017
0.20.0 6,653 6/1/2017
0.19.5 16,198 5/26/2017
0.19.4 6,734 5/13/2017
0.19.3 5,826 5/11/2017
0.19.2 2,581,812 5/1/2017
0.16.2 30,424 4/2/2017
0.10.0 13,829 12/29/2016
0.9.0 7,149 12/13/2016
0.8.0 8,160 12/7/2016
0.7.4 6,033 12/7/2016
0.7.3 63,033 11/28/2016
0.7.2 17,676 11/23/2016
0.7.1 10,551 11/21/2016
0.7.0 8,851 11/13/2016
0.6.2 28,154 10/28/2016
0.6.1 6,493 10/27/2016
0.6.0 6,097 10/23/2016
0.5.0 6,649 10/20/2016
0.4.0 7,669 10/13/2016
0.3.0 6,199 10/12/2016
0.2.1 5,939 10/10/2016
0.2.0 6,031 10/9/2016
0.1.0 21,070 10/4/2016