ZetCode

C# MySQL

最后修改于 2023 年 7 月 5 日

在本文中,我们将展示如何在 C# 中编程 MySQL。 我们使用 ADO.NET。

MySQL

MySQL 是一个领先的开源数据库管理系统。它是一个多用户、多线程的数据库管理系统。MySQL 在 Web 上尤其受欢迎。MySQL 数据库可在大多数重要的操作系统平台上使用。它可以在 BSD Unix、Linux、Windows 或 Mac OS 上运行。 MySQL 有两个版本:MySQL 服务器系统和 MySQL 嵌入式系统。

ADO.NET

ADO.NET 是一种规范,它统一了对关系数据库、XML 文件和其他应用程序数据的访问。 MySql.Data 是 ADO.NET 规范针对 MySQL 数据库的实现。它是一个用 C# 语言编写的驱动程序,可用于所有 .NET 语言。

$ dotnet add package MySql.Data

我们将该包包含到我们的 .NET Core 项目中。

MySqlConnectionMySqlCommandMySqlDataReaderDataSetMySqlDataProvider 是 .NET 数据提供程序模型的核心元素。 MySqlConnection 创建到特定数据源的连接。 MySqlCommand 对象针对数据源执行 SQL 语句。 MySqlDataReader 从数据源读取数据流。

DataSet 对象用于脱机处理大量数据。 它是一个断开连接的数据表示,可以保存来自各种不同来源的数据。 MySqlDataReaderDataSet 都用于处理数据;它们在不同的情况下使用。 如果我们只需要读取查询的结果,那么 MySqlDataReader 是更好的选择。 如果我们需要对数据进行更广泛的处理,或者我们想将 Winforms 控件绑定到数据库表,那么 DataSet 是首选。

C# MySQL 版本

在下面的程序中,我们检查 MySQL 服务器的版本。

Program.cs
using MySql.Data.MySqlClient;

string cs = @"server=localhost;userid=dbuser;password=s$cret;database=testdb";

using var con = new MySqlConnection(cs);
con.Open();

Console.WriteLine($"MySQL version : {con.ServerVersion}");

我们连接到数据库并获取一些关于 MySQL 服务器的信息。

using MySql.Data.MySqlClient; 

我们导入 MySQL 数据提供程序的元素。

string cs = @"server=localhost;userid=dbuser;password=s$cret;database=testdb";

这是连接字符串。数据提供程序使用它来建立与数据库的连接。我们指定主机名、用户名、密码和数据库名称。

using var con = new MySqlConnection(cs);

创建一个 MySQLConnection 对象。 此对象用于打开与数据库的连接。 当变量超出范围时,using 语句会释放数据库连接资源。

con.Open();

此行打开数据库连接。

Console.WriteLine($"MySQL version : {con.ServerVersion}");

在这里,我们使用连接对象的 ServerVersion 属性打印 MySQL 的版本。

$ dotnet run
MySQL version: 8.0.29-0ubuntu0.22.04.2

C# MySQL SELECT 语句

以下示例使用 SELECT 语句确定 MySQL 的版本。

Program.cs
using MySql.Data.MySqlClient;

string cs = @"server=localhost;userid=dbuser;password=s$cret;database=mydb";

using var con = new MySqlConnection(cs);
con.Open();

var stm = "SELECT VERSION()";
var cmd = new MySqlCommand(stm, con);

var version = cmd.ExecuteScalar().ToString();
Console.WriteLine($"MySQL version: {version}");

我们检查 MySQL 数据库的版本。这次使用 SQL 查询。

var stm = "SELECT VERSION()";

这是 SQL SELECT 语句。它返回数据库的版本。 VERSION 是一个内置的 MySQL 函数。

var cmd = new MySqlCommand(stm, con);

MySqlCommand 是一个对象,用于在数据库上执行查询。 这些参数是 SQL 语句和连接对象。

var version = cmd.ExecuteScalar().ToString();

有些查询只返回一个标量值。在我们的例子中,我们想要一个简单的字符串,指定数据库的版本。 ExecuteScalar 用于这种情况。

C# MySQL 创建表

在下面的示例中,我们创建一个数据库表并用数据填充它。

Program.cs
using MySql.Data.MySqlClient;

string cs = @"server=localhost;userid=dbuser;password=s$cret;database=testdb";

using var con = new MySqlConnection(cs);
con.Open();

using var cmd = new MySqlCommand();
cmd.Connection = con;

cmd.CommandText = "DROP TABLE IF EXISTS cars";
cmd.ExecuteNonQuery();

cmd.CommandText = @"CREATE TABLE cars(id INTEGER PRIMARY KEY AUTO_INCREMENT,
        name TEXT, price INT)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Audi',52642)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Mercedes',57127)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Skoda',9000)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Volvo',29000)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Bentley',350000)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Citroen',21000)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Hummer',41400)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Volkswagen',21600)";
cmd.ExecuteNonQuery();

Console.WriteLine("Table cars created");

在这个例子中,我们创建了一个包含八行数据的 cars 表。

cmd.CommandText = "DROP TABLE IF EXISTS cars";
cmd.ExecuteNonQuery();

首先,如果表已存在,我们先删除它。当我们不想要结果集时,例如对于 DROPINSERTDELETE 语句,我们使用 ExecuteNonQuery 方法。

cmd.CommandText = @"CREATE TABLE cars(id INTEGER PRIMARY KEY AUTO_INCREMENT,
        name TEXT, price INT)";
cmd.ExecuteNonQuery();;

创建 cars 表。 AUTO_INCREMENT 关键字使该列在 MySQL 中自动递增。

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Audi',52642)";
cmd.ExecuteNonQuery();

cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Mercedes',57127)";
cmd.ExecuteNonQuery();
...

这里我们将两行插入到表中。

$ dotnet run
Table cars created

我们运行该程序。

$ mysql -u dbuser -p

我们使用 mysql 工具连接到 MySQL 服务器。

MariaDB [(none)]> use testdb;
Database changed
MariaDB [testdb]> SELECT * FROM cars;
+----+------------+--------+
| id | name       | price  |
+----+------------+--------+
|  1 | Audi       |  52642 |
|  2 | Mercedes   |  57127 |
|  3 | Skoda      |   9000 |
|  4 | Volvo      |  29000 |
|  5 | Bentley    | 350000 |
|  6 | Citroen    |  21000 |
|  7 | Hummer     |  41400 |
|  8 | Volkswagen |  21600 |
+----+------------+--------+
8 rows in set (0.00 sec)

我们验证数据。cars 表已成功创建。

C# MySQL 预处理语句

预处理语句可以提高安全性和性能。当我们编写预处理语句时,我们使用占位符而不是直接将值写入语句中。

Program.cs
using MySql.Data.MySqlClient;

string cs = @"server=localhost;userid=dbuser;password=s$cret;database=testdb";

using var con = new MySqlConnection(cs);
con.Open();

var sql = "INSERT INTO cars(name, price) VALUES(@name, @price)";
using var cmd = new MySqlCommand(sql, con);

cmd.Parameters.AddWithValue("@name", "BMW");
cmd.Parameters.AddWithValue("@price", 36600);
cmd.Prepare();

cmd.ExecuteNonQuery();

Console.WriteLine("row inserted");

我们向 cars 表添加一辆新车。 我们使用参数化命令。

var sql = "INSERT INTO cars(name, price) VALUES(@name, @price)";
using var cmd = new MySqlCommand(sql, con);

当我们编写预处理语句时,我们使用占位符而不是直接将值写入语句。 预处理语句速度更快,并能防止 SQL 注入攻击。 @name@price 是占位符,稍后将被填充。

cmd.Parameters.AddWithValue("@name", "BMW");
cmd.Parameters.AddWithValue("@price", 36600);
cmd.Prepare();

使用 AddWithValue 方法将值绑定到占位符。

cmd.ExecuteNonQuery();

执行预处理语句。 当我们不希望返回任何数据时,我们使用 MySQLCommand 对象的 ExecuteNonQuery 方法。

C# MySqlDataReader

MySqlDataReader 是一个用于从数据库检索数据的对象。它提供对查询结果的快速、仅向前、只读的访问。 这是从表中检索数据的最有效方式。

Program.cs
using MySql.Data.MySqlClient;

string cs = @"server=localhost;userid=dbuser;password=s$cret;database=testdb";

using var con = new MySqlConnection(cs);
con.Open();

string sql = "SELECT * FROM cars";
using var cmd = new MySqlCommand(sql, con);

using MySqlDataReader rdr = cmd.ExecuteReader();

while (rdr.Read())
{
    Console.WriteLine("{0} {1} {2}", rdr.GetInt32(0), rdr.GetString(1), 
            rdr.GetInt32(2));
}

我们从 cars 表中获取所有行并将它们打印到控制台。

using MySqlDataReader rdr = cmd.ExecuteReader();

要创建 MySQLDataReader,我们调用 MySqlCommand 对象的 ExecuteReader 方法。

while (rdr.Read())
{
    Console.WriteLine("{0} {1} {2}", rdr.GetInt32(0), rdr.GetString(1), 
            rdr.GetInt32(2));
}

Read 方法将数据读取器前进到下一条记录。 如果有更多行,则返回 true;否则返回 false。 我们可以使用数组索引表示法检索该值,或者使用特定的方法以其本机数据类型访问列值。 后者效率更高。

$ dotnet run
1 Audi 52642
2 Mercedes 57127
3 Skoda 9000
4 Volvo 29000
5 Bentley 350000
6 Citroen 21000
7 Hummer 41400
8 Volkswagen 21600
9 BMW 36600

C# MySQL 列标题

在下面的示例中,我们将列标题与数据库表中的数据一起打印出来。

Program.cs
using MySql.Data.MySqlClient;

string cs = @"server=localhost;userid=dbuser;password=s$cret;database=testdb";

using var con = new MySqlConnection(cs);
con.Open();

var sql = "SELECT * FROM cars";

using var cmd = new MySqlCommand(sql, con);

using MySqlDataReader rdr = cmd.ExecuteReader();
Console.WriteLine($"{rdr.GetName(0),-4} {rdr.GetName(1),-10} {rdr.GetName(2),10}");

while (rdr.Read())
{
    Console.WriteLine($"{rdr.GetInt32(0),-4} {rdr.GetString(1),-10} {rdr.GetInt32(2),10}");
}

在该示例中,我们选择 cars 表中的所有行及其列名。

Console.WriteLine($"{rdr.GetName(0),-4} {rdr.GetName(1),-10} {rdr.GetName(2),10}");

我们使用读取器的 GetName 方法获取列名。

while (rdr.Read())
{
    Console.WriteLine($"{rdr.GetInt32(0),-4} {rdr.GetString(1),-10} {rdr.GetInt32(2),10}");
}

我们将 SQL 语句返回的数据打印到终端。

$ dotnet run
id   name            price
1    Audi            52642
2    Mercedes        57127
3    Skoda            9000
4    Volvo           29000
5    Bentley        350000
6    Citroen         21000
7    Hummer          41400
8    Volkswagen      21600
9    BMW             36600

来源

MySQL Connector/NET 开发人员指南

在本文中,我们展示了如何在 C# 中编程 MySQL 数据库。

作者

我叫 Jan Bodnar,是一位充满热情的程序员,拥有丰富的编程经验。我从 2007 年开始撰写编程文章。到目前为止,我已经撰写了超过 1,400 篇文章和 8 本电子书。我拥有超过十年的编程教学经验。

列出所有 C# 教程