C#实现基于ADO.NET框架的DBHelper工具类

在C#中，基于ADO.NET框架实现一个DBHelper工具类是一种常见的做法，用于简化数据库操作的代码。以下是一个简单的DBHelper类示例，它使用SqlConnection来连接SQL Server数据库，并提供了执行SQL命令、查询数据等基本功能。请注意，为了示例的简洁性，这里不包括错误处理和连接字符串的加密或安全存储。

首先，确保项目中已经引用了System.Data和System.Data.SqlClient（对于.NET Core或.NET 5/6/7等较新版本，可能需要安装NuGet包Microsoft.Data.SqlClient）。

using System;  
using System.Collections.Generic;  
using System.Data;  
using System.Data.SqlClient; // 或 Microsoft.Data.SqlClient  
  
public class DBHelper  
{  
    // 连接字符串，请根据实际情况修改  
    private readonly string _connectionString = "Server=your_server;Database=your_database;User Id=your_username;Password=your_password;";  
  
    // 私有构造函数，防止外部实例化  
    private DBHelper() { }  
  
    // 获取数据库连接  
    private SqlConnection GetConnection()  
    {  
        return new SqlConnection(_connectionString);  
    }  
  
    // 执行非查询SQL语句（如INSERT、UPDATE、DELETE）  
    public int ExecuteNonQuery(string sql, params SqlParameter[] parameters)  
    {  
        using (SqlConnection conn = GetConnection())  
        {  
            using (SqlCommand cmd = new SqlCommand(sql, conn))  
            {  
                if (parameters != null)  
                {  
                    cmd.Parameters.AddRange(parameters);  
                }  
                conn.Open();  
                return cmd.ExecuteNonQuery();  
            }  
        }  
    }  
  
    // 执行查询SQL语句，并返回DataTable  
    public DataTable ExecuteDataTable(string sql, params SqlParameter[] parameters)  
    {  
        DataTable dt = new DataTable();  
        using (SqlConnection conn = GetConnection())  
        {  
            using (SqlCommand cmd = new SqlCommand(sql, conn))  
            {  
                if (parameters != null)  
                {  
                    cmd.Parameters.AddRange(parameters);  
                }  
                using (SqlDataAdapter adapter = new SqlDataAdapter(cmd))  
                {  
                    conn.Open();  
                    adapter.Fill(dt);  
                }  
            }  
        }  
        return dt;  
    }  
  
    // 执行查询SQL语句，并返回第一行第一列的结果（常用于查询单个值）  
    public object ExecuteScalar(string sql, params SqlParameter[] parameters)  
    {  
        using (SqlConnection conn = GetConnection())  
        {  
            using (SqlCommand cmd = new SqlCommand(sql, conn))  
            {  
                if (parameters != null)  
                {  
                    cmd.Parameters.AddRange(parameters);  
                }  
                conn.Open();  
                return cmd.ExecuteScalar();  
            }  
        }  
    }  
  
    // 更多方法可以根据需要添加，如执行存储过程等  
}  
  
// 使用示例  
class Program  
{  
    static void Main(string[] args)  
    {  
        DBHelper dbHelper = new DBHelper(); // 注意：由于构造函数是私有的，这里应该通过静态方法或单例模式获取实例  
  
        // 示例：插入数据  
        string insertSql = "INSERT INTO YourTable (Column1, Column2) VALUES (@Param1, @Param2)";  
        int affectedRows = dbHelper.ExecuteNonQuery(insertSql, new SqlParameter("@Param1", "Value1"), new SqlParameter("@Param2", "Value2"));  
  
        // 示例：查询数据  
        DataTable dataTable = dbHelper.ExecuteDataTable("SELECT * FROM YourTable");  
  
        // 示例：查询单个值  
        object singleValue = dbHelper.ExecuteScalar("SELECT COUNT(*) FROM YourTable");  
  
        // 输出结果（仅为示例）  
        Console.WriteLine($"Inserted rows: {affectedRows}");  
        // 遍历DataTable或处理singleValue...  
    }  
}  
  
// 注意：由于DBHelper类构造函数是私有的，上述Main方法中的实例化是示意性的。  
// 实践中，可能需要通过静态方法或单例模式来获取DBHelper的实例。

请注意，上面的DBHelper类使用了私有构造函数来防止外部直接实例化，这在实际应用中是一个好习惯，因为它允许控制类的实例化方式（例如，通过静态方法或单例模式）。然而，在Main方法中实例化DBHelper的示例是示意性的，因为构造函数是私有的。在实际应用中，应该通过静态方法来获取DBHelper的实例。