C#中如何监控数据库连接状态?有什么事件可用?

来源:这里教程网 时间:2026-02-21 17:28:39 作者:

在C#中监控数据库连接状态,主要依赖于所使用的数据库提供程序。以最常见的 SqlConnection(用于 SQL Server)为例,.NET Framework 和 .NET Core/.NET 5+ 提供了直接的方式来感知连接状态的变化。

SqlConnection.StateChange 事件

这是监控连接状态最核心的机制。当连接的 State 属性发生变化时(例如从 Closed 变为 Open,或从 Open 变为 Closed),会触发此事件。

你可以订阅这个事件,在连接打开或关闭时执行自定义逻辑,比如记录日志、更新UI状态或重试连接。

示例代码:

using System;
using System.Data;
using Microsoft.Data.SqlClient; // 或 using System.Data.SqlClient;
class Program
{
    static void Main()
    {
        string connectionString = "Server=localhost;Database=TestDB;Integrated Security=true;";
        using (var connection = new SqlConnection(connectionString))
        {
            // 订阅 StateChange 事件
            connection.StateChange += Connection_StateChange;
            try
            {
                connection.Open();
                Console.WriteLine("连接已打开");
                // 模拟一些操作
                System.Threading.Thread.Sleep(1000);
            }
            catch (Exception ex)
            {
                Console.WriteLine($"连接失败: {ex.Message}");
            }
            finally
            {
                // 显式关闭连接,会触发 StateChange
                if (connection.State == ConnectionState.Open)
                    connection.Close();
            }
        }
    }
    // 事件处理方法
    static void Connection_StateChange(object sender, StateChangeEventArgs e)
    {
        Console.WriteLine($"连接状态变化: 从 '{e.OriginalState}' 变为 '{e.CurrentState}'");
        if (e.CurrentState == ConnectionState.Open)
        {
            Console.WriteLine("✅ 数据库连接已成功建立。");
        }
        else if (e.CurrentState == ConnectionState.Closed)
        {
            Console.WriteLine("❌ 数据库连接已关闭。");
        }
    }
}

如何主动检查连接状态?

除了事件监听,你也可以通过 Connection.State 属性来获取当前连接的状态。它返回一个 ConnectionState 枚举值,常见值包括:

Broken:连接中断(如网络问题) Open:连接已打开 Closed:连接已关闭

简单判断示例:

if (connection.State == ConnectionState.Open)
{
    Console.WriteLine("连接正常");
}
else
{
    Console.WriteLine("连接未打开或已断开");
}

注意点与最佳实践

虽然有 StateChange 事件,但要注意:

该事件不会检测到网络突然中断。如果连接在使用过程中因网络故障断开,State 属性可能仍显示为 Open,直到你尝试执行命令才会抛出异常。 真正可靠的“健康检查”通常需要执行一个轻量级查询,如 SELECT 1,并捕获可能的异常。 推荐使用连接池(默认开启),避免频繁创建和销毁连接。StateChange 在连接从池中取出或归还时也可能触发。 对于其他数据库(如 PostgreSQL 的 NpgsqlConnection、MySQL 的 MySqlConnection),也提供类似的 StateChange 事件,用法一致。

基本上就这些。StateChange 适合监听显式的打开/关闭动作,而真正的连接存活检测还需结合实际操作中的异常处理。

相关推荐