CMySQL 连接字符串|极客笔记

C# MySQL 连接字符串

概述

在开发C#应用程序中，与MySQL数据库进行交互是非常常见的一种需求。为了实现这一目的，我们需要使用MySQL连接字符串来建立与数据库的连接。

连接字符串是一个包含数据库连接信息的文本，它告诉应用程序如何连接到数据库。在连接字符串中，我们需要指定MySQL服务器的地址、端口号、数据库名称以及用户凭据等等。正确构建和使用连接字符串是确保我们的应用程序能够成功连接到数据库并执行所需操作的关键。

本文将详细介绍如何构建C#中与MySQL数据库连接所需的连接字符串，并提供一些示例代码来演示连接字符串的使用。

连接字符串的结构

MySQL的连接字符串通常由多个键值对组成，用分号(;)分隔。每个键值对表示一个特定的连接选项。以下是一些常见的连接选项：

Server：MySQL服务器的地址
Port：MySQL服务器的端口号
Database：要连接的数据库名称
User Id：用于连接的用户名
Password：用户的密码
Charset：连接使用的字符集
Pooling：是否启用连接池
Connection Timeout：连接超时时间

下面是一个典型的MySQL连接字符串的示例：

Server=localhost;Port=3306;Database=mydatabase;Uid=myusername;Pwd=mypassword;Charset=utf8;Pooling=true;Connection Timeout=30;

在实际使用中，我们需要根据具体的连接需求来构建连接字符串。下面我们将详细说明如何构建C#中连接MySQL数据库所需的连接字符串。

构建连接字符串

手动构建连接字符串

手动构建连接字符串是最基本的方法，我们可以直接将连接选项逐个拼接到字符串中。下面是一个手动构建连接字符串的示例代码：

string server = "localhost";
int port = 3306;
string database = "mydatabase";
string user = "myusername";
string password = "mypassword";
string charset = "utf8";
bool pooling = true;
int timeout = 30;

string connectionString = "Server=" + server + ";Port=" + port + ";Database=" + database + ";Uid=" + user + ";Pwd=" + password + ";Charset=" + charset + ";Pooling=" + pooling.ToString() + ";Connection Timeout=" + timeout.ToString() + ";";

使用连接字符串构建器

为了更方便地构建连接字符串，C#提供了MySqlConnectionStringBuilder类。这个类提供了一种便捷的方式来构建和解析连接字符串。下面是一个使用连接字符串构建器的示例代码：

MySqlConnectionStringBuilder builder = new MySqlConnectionStringBuilder();
builder.Server = "localhost";
builder.Port = 3306;
builder.Database = "mydatabase";
builder.UserID = "myusername";
builder.Password = "mypassword";
builder.CharacterSet = "utf8";
builder.Pooling = true;
builder.ConnectionTimeout = 30;

string connectionString = builder.ToString();

从配置文件中读取连接字符串

另一种常见的方法是从应用程序的配置文件（如.config文件）中读取连接字符串。在配置文件中，我们可以将连接字符串保存在一个名为connectionStrings的节点中，并使用定义好的键名来引用它。下面是一个从配置文件中读取连接字符串的示例代码：

string connectionString = ConfigurationManager.ConnectionStrings["myConnection"].ConnectionString;

在应用程序配置文件中，我们需要添加如下节点来定义连接字符串：

<configuration>
  <connectionStrings>
    <add name="myConnection" connectionString="Server=localhost;Port=3306;Database=mydatabase;Uid=myusername;Pwd=mypassword;Charset=utf8;Pooling=true;Connection Timeout=30;" />
  </connectionStrings>
</configuration>

使用连接字符串

一旦我们构建了连接字符串，就可以使用它来建立与MySQL数据库的连接。下面是一个使用连接字符串连接数据库并执行查询的示例代码：

using MySql.Data.MySqlClient;

string connectionString = "Server=localhost;Port=3306;Database=mydatabase;Uid=myusername;Pwd=mypassword;Charset=utf8;Pooling=true;Connection Timeout=30;";

using (MySqlConnection connection = new MySqlConnection(connectionString))
{
    try
    {
        connection.Open();
        // 执行数据库操作
    }
    catch (Exception ex)
    {
        Console.WriteLine("连接数据库时发生错误：" + ex.Message);
    }
}

在上面的示例代码中，我们使用using语句来确保连接对象在使用完毕后能够被正确关闭和释放。

示例代码运行结果

为了演示连接字符串的使用，我们可以编写一个简单的程序来执行查询并输出结果。假设我们有一个包含users表的数据库，其中包含id和name两列，我们可以通过以下代码获取所有用户记录并输出到控制台：

using MySql.Data.MySqlClient;

string connectionString = "Server=localhost;Port=3306;Database=mydatabase;Uid=myusername;Pwd=mypassword;Charset=utf8;Pooling=true;Connection Timeout=30;";

using (MySqlConnection connection = new MySqlConnection(connectionString))
{
    try
    {
        connection.Open();

        string sql = "SELECT * FROM users";
        MySqlCommand command = new MySqlCommand(sql, connection);

        using (MySqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                int id = reader.GetInt32("id");
                string name = reader.GetString("name");

                Console.WriteLine("ID: {0}, Name: {1}", id, name);
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("连接数据库时发生错误：" + ex.Message);
    }
}

假设users表中包含以下记录：

id | name
---|------
1  | Alice
2  | Bob
3  | Charlie

运行以上示例代码，输出结果将会是：

ID: 1, Name: Alice
ID: 2, Name: Bob
ID: 3, Name: Charlie

结论

本文详细介绍了在C#中使用MySQL连接字符串来连接数据库的方法。我们学习了连接字符串的结构和常见连接选项，并提供了手动构建、使用连接字符串构建器以及从配置文件中读取连接字符串的示例代码。最后，我们给出了一个简单的示例程序来演示连接字符串的使用和查询结果的处理。

通过学习和理解连接字符串的使用方法，我们可以更加灵活和高效地与MySQL数据库进行交互，为我们的C#应用程序提供强大的数据存储和操作能力。

CMySQL 连接字符串