MySqlConnector 2.4.0-beta.2
Prefix ReservedSee the version list below for details.
dotnet add package MySqlConnector --version 2.4.0-beta.2
NuGet\Install-Package MySqlConnector -Version 2.4.0-beta.2
<PackageReference Include="MySqlConnector" Version="2.4.0-beta.2" />
paket add MySqlConnector --version 2.4.0-beta.2
#r "nuget: MySqlConnector, 2.4.0-beta.2"
// Install MySqlConnector as a Cake Addin #addin nuget:?package=MySqlConnector&version=2.4.0-beta.2&prerelease // Install MySqlConnector as a Cake Tool #tool nuget:?package=MySqlConnector&version=2.4.0-beta.2&prerelease
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 ofDbConnection
)MySqlCommand
(implementation ofDbCommand
)MySqlDataReader
(implementation ofDbDataReader
)MySqlBulkCopy
MySqlBulkLoader
MySqlConnectionStringBuilder
MySqlConnectorFactory
MySqlDataAdapter
MySqlException
MySqlTransaction
(implementation ofDbTransaction
)
Related Packages
- Dependency Injection: MySqlConnector.DependencyInjection
- Entity Framework Core: Pomelo.EntityFrameworkCore.MySql
Feedback
MySqlConnector is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.
Product | Versions 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. |
.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. |
-
.NETFramework 4.6.2
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- System.Diagnostics.DiagnosticSource (>= 8.0.1)
- System.Threading.Tasks.Extensions (>= 4.5.4)
-
.NETFramework 4.7.1
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- System.Diagnostics.DiagnosticSource (>= 8.0.1)
- System.Threading.Tasks.Extensions (>= 4.5.4)
-
.NETFramework 4.8
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- System.Diagnostics.DiagnosticSource (>= 8.0.1)
- System.Threading.Tasks.Extensions (>= 4.5.4)
-
.NETStandard 2.0
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- System.Diagnostics.DiagnosticSource (>= 8.0.1)
- System.Threading.Tasks.Extensions (>= 4.5.4)
-
.NETStandard 2.1
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- System.Diagnostics.DiagnosticSource (>= 8.0.1)
-
net6.0
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- System.Diagnostics.DiagnosticSource (>= 8.0.1)
-
net8.0
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
-
net9.0
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
NuGet packages (611)
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 (123)
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 | 198,022 | 11/12/2024 | |
2.4.0-beta.2 | 1,606 | 10/20/2024 | |
2.4.0-beta.1 | 811 | 10/14/2024 | |
2.3.7 | 2,581,314 | 4/22/2024 | |
2.3.6 | 449,261 | 3/20/2024 | |
2.3.5 | 7,883,868 | 1/20/2024 | |
2.3.4 | 236,215 | 1/14/2024 | |
2.3.3 | 272,531 | 12/19/2023 | |
2.3.2 | 11,558 | 12/18/2023 | |
2.3.1 | 1,578,087 | 11/17/2023 | |
2.3.0 | 146,769 | 11/14/2023 | |
2.2.7 | 2,305,175 | 7/21/2023 | |
2.2.6 | 1,540,343 | 5/4/2023 | |
2.2.5 | 14,706,452 | 1/1/2023 | |
2.2.4 | 104,801 | 12/23/2022 | |
2.2.3 | 600,630 | 12/18/2022 | |
2.2.2 | 696,550 | 12/6/2022 | |
2.2.1 | 439,471 | 11/21/2022 | |
2.2.0 | 810,061 | 11/8/2022 | |
2.1.13 | 1,818,426 | 8/26/2022 | |
2.1.12 | 154,745 | 8/12/2022 | |
2.1.11 | 522,992 | 7/14/2022 | |
2.1.10 | 1,640,133 | 6/4/2022 | |
2.1.9 | 253,188 | 5/16/2022 | |
2.1.8 | 1,112,351 | 3/7/2022 | |
2.1.7 | 301,925 | 2/20/2022 | |
2.1.6 | 87,714 | 2/10/2022 | |
2.1.5 | 258,779 | 1/30/2022 | |
2.1.4 | 107,062 | 1/25/2022 | |
2.1.3 | 8,352 | 1/25/2022 | |
2.1.2 | 20,560,411 | 12/23/2021 | |
2.1.1 | 10,870 | 12/21/2021 | |
2.1.0 | 1,361,058 | 11/28/2021 | |
2.0.0 | 5,607,036 | 11/9/2021 | |
1.3.14 | 1,130,959 | 10/20/2021 | |
1.3.13 | 3,162,341 | 10/2/2021 | |
1.3.12 | 280,552 | 9/11/2021 | |
1.3.11 | 2,520,236 | 7/2/2021 | |
1.3.10 | 2,523,970 | 6/16/2021 | |
1.3.9 | 598,604 | 5/27/2021 | |
1.3.8 | 390,664 | 4/30/2021 | |
1.3.7 | 1,937,886 | 4/24/2021 | |
1.3.6 | 3,747 | 4/24/2021 | |
1.3.5 | 8,768 | 4/23/2021 | |
1.3.4 | 127,633 | 4/21/2021 | |
1.3.3 | 154,266 | 4/12/2021 | |
1.3.2 | 674,285 | 3/22/2021 | |
1.3.1 | 189,752 | 3/11/2021 | |
1.3.0 | 207,277 | 3/7/2021 | |
1.2.1 | 1,204,835 | 12/12/2020 | |
1.2.0 | 389,724 | 11/26/2020 | |
1.1.0 | 2,684,611 | 11/10/2020 | |
1.0.1 | 2,130,678 | 8/13/2020 | |
1.0.0 | 2,521,626 | 7/11/2020 | |
0.69.10 | 2,308,910 | 10/21/2020 | |
0.69.9 | 4,145,953 | 8/20/2020 | |
0.69.8 | 130,503 | 7/20/2020 | |
0.69.7 | 6,822 | 7/16/2020 | |
0.69.6 | 145,943 | 7/7/2020 | |
0.69.5 | 82,782 | 7/1/2020 | |
0.69.4 | 33,795 | 6/25/2020 | |
0.69.3 | 190,116 | 6/16/2020 | |
0.69.2 | 20,303 | 6/12/2020 | |
0.69.1 | 9,893 | 6/10/2020 | |
0.69.0 | 19,612 | 6/8/2020 | |
0.68.1 | 6,542 | 6/8/2020 | |
0.68.0 | 4,539 | 6/6/2020 | |
0.67.0 | 69,036 | 5/30/2020 | |
0.66.0 | 375,627 | 5/7/2020 | |
0.65.0 | 30,471 | 5/3/2020 | |
0.64.2 | 35,275 | 4/28/2020 | |
0.64.1 | 30,346 | 4/26/2020 | |
0.64.0 | 52,593 | 4/18/2020 | |
0.63.2 | 247,927 | 4/9/2020 | |
0.63.1 | 316,250 | 4/4/2020 | |
0.63.0 | 49,460 | 3/26/2020 | |
0.62.0 | 324,432 | 2/29/2020 | |
0.61.0 | 7,906,186 | 11/5/2019 | |
0.60.4 | 18,028 | 11/4/2019 | |
0.60.3 | 362,657 | 10/28/2019 | |
0.60.2 | 194,612 | 10/21/2019 | |
0.60.1 | 7,404 | 10/20/2019 | |
0.60.0 | 16,610 | 10/19/2019 | |
0.59.2 | 1,813,048 | 10/4/2019 | |
0.59.1 | 17,480 | 9/30/2019 | |
0.59.0 | 30,230 | 9/25/2019 | |
0.58.0 | 62,406 | 9/24/2019 | |
0.57.0 | 8,639 | 9/23/2019 | |
0.56.0 | 2,432,153 | 5/26/2019 | |
0.55.0 | 36,319 | 5/24/2019 | |
0.54.0 | 70,354 | 5/11/2019 | |
0.53.0 | 170,828 | 4/19/2019 | |
0.52.0 | 151,068 | 4/11/2019 | |
0.51.1 | 124,974 | 3/27/2019 | |
0.51.0 | 9,100 | 3/27/2019 | |
0.50.0 | 45,106 | 3/18/2019 | |
0.49.3 | 200,624 | 1/24/2019 | |
0.49.2 | 4,671,465 | 1/16/2019 | |
0.49.0 | 9,229 | 1/12/2019 | |
0.48.2 | 131,057 | 12/12/2018 | |
0.48.1 | 9,403 | 12/10/2018 | |
0.48.0 | 19,778 | 12/8/2018 | |
0.47.1 | 3,312,880 | 11/4/2018 | |
0.47.0 | 6,113 | 11/3/2018 | |
0.46.2 | 18,572 | 10/25/2018 | |
0.46.1 | 108,394 | 10/16/2018 | |
0.46.0 | 13,656 | 10/12/2018 | |
0.45.1 | 840,153 | 9/29/2018 | |
0.45.0 | 33,425 | 9/13/2018 | |
0.44.1 | 1,303,763 | 8/24/2018 | |
0.44.0 | 10,258 | 8/21/2018 | |
0.43.0 | 125,834 | 7/27/2018 | |
0.42.3 | 50,512 | 7/6/2018 | |
0.42.2 | 92,072 | 6/30/2018 | |
0.42.1 | 998,011 | 6/16/2018 | |
0.42.0 | 19,443 | 6/9/2018 | |
0.41.0 | 6,339 | 6/8/2018 | |
0.40.4 | 897,508 | 5/19/2018 | |
0.40.3 | 71,071 | 4/26/2018 | |
0.40.2 | 26,180 | 4/19/2018 | |
0.36.0 | 49,901 | 2/16/2018 | |
0.35.0 | 74,019 | 1/21/2018 | |
0.32.0 | 1,013,826 | 11/24/2017 | |
0.30.0 | 94,880 | 10/31/2017 | |
0.29.4 | 27,166 | 10/31/2017 | |
0.29.2 | 67,827 | 10/26/2017 | |
0.26.5 | 33,584 | 9/22/2017 | |
0.26.4 | 350,212 | 9/13/2017 | |
0.26.3 | 5,226 | 9/13/2017 | |
0.26.2 | 52,773 | 9/7/2017 | |
0.26.1 | 30,086 | 9/3/2017 | |
0.26.0 | 38,354 | 8/25/2017 | |
0.25.1 | 102,198 | 8/17/2017 | |
0.25.0 | 34,531 | 8/13/2017 | |
0.20.0 | 6,677 | 6/1/2017 | |
0.19.5 | 16,217 | 5/26/2017 | |
0.19.4 | 6,756 | 5/13/2017 | |
0.19.3 | 5,847 | 5/11/2017 | |
0.19.2 | 2,619,385 | 5/1/2017 | |
0.16.2 | 30,449 | 4/2/2017 | |
0.10.0 | 13,851 | 12/29/2016 | |
0.9.0 | 7,181 | 12/13/2016 | |
0.8.0 | 8,185 | 12/7/2016 | |
0.7.4 | 6,057 | 12/7/2016 | |
0.7.3 | 63,090 | 11/28/2016 | |
0.7.2 | 17,751 | 11/23/2016 | |
0.7.1 | 10,570 | 11/21/2016 | |
0.7.0 | 8,872 | 11/13/2016 | |
0.6.2 | 28,178 | 10/28/2016 | |
0.6.1 | 6,513 | 10/27/2016 | |
0.6.0 | 6,120 | 10/23/2016 | |
0.5.0 | 6,673 | 10/20/2016 | |
0.4.0 | 7,689 | 10/13/2016 | |
0.3.0 | 6,221 | 10/12/2016 | |
0.2.1 | 5,956 | 10/10/2016 | |
0.2.0 | 6,052 | 10/9/2016 | |
0.1.0 | 21,502 | 10/4/2016 |