在C#開發中，與數據庫的交互是常見的需求。通常，我們會使用ADO.NET直接執行SQL查詢，雖然這種方法非常靈活，但容易導致代碼重復，并且在處理多個SQL語句時容易出錯。為了提高代碼的可維護性和復用性，封裝一個通用的數據庫操作助手類（DBHelper）是非常有必要的。本文將詳細介紹如何創建和使用一個DBHelper類來簡化數據庫操作。

一、ADO.NET簡介

ADO.NET是.NET框架中用于與數據庫交互的核心組件。它提供了一套用于連接數據庫、執行SQL查詢、插入、更新和刪除數據的類庫，包括SqlConnection、SqlCommand、SqlDataReader等。這些類提供了對底層數據庫操作的直接控制，但同時也要求開發者手動編寫SQL語句和管理數據庫連接，容易導致代碼冗長和重復。正因為如此，在復雜項目中，開發者往往會選擇封裝這些底層操作，以提高代碼的復用性和維護性。

ADO.NET 特色類庫

二、DBHelper類的設計

DBHelper類的核心目標是封裝常用的數據庫操作，如執行查詢、執行命令、獲取數據集等。它通過統一的接口和簡單的封裝，減少了直接與ADO.NET打交道的復雜性，使得數據庫操作更加簡潔和安全。

DBHelper工具類示例代碼如下：

namespace Test
{
    public static class DBHelper
    {
        // 請根據實際情況設置數據庫連接字符串
        private static readonly string connectionString = "your_connection_string_here";

        /// <summary>
        /// 執行一個查詢，返回結果集中第一行的第一列。
        /// </summary>
        public static int GetScalar(string sql, SqlParameter[] parameters = null)
        {
            using (SqlConnection conn = new SqlConnection(connectionString))
            {
                using (SqlCommand cmd = new SqlCommand(sql, conn))
                {
                    if (parameters != null)
                    {
                        cmd.Parameters.AddRange(parameters);
                    }

                    conn.Open();
                    object result = cmd.ExecuteScalar();
                    return result != null ? Convert.ToInt32(result) : 0;
                }
            }
        }

        /// <summary>
        /// 執行一個查詢，返回一個數據讀取器(SqlDataReader)。
        /// </summary>
        public static SqlDataReader GetReader(string sql, SqlParameter[] parameters = null)
        {
            SqlConnection conn = new SqlConnection(connectionString);
            SqlCommand cmd = new SqlCommand(sql, conn);

            if (parameters != null)
            {
                cmd.Parameters.AddRange(parameters);
            }

            conn.Open();
            return cmd.ExecuteReader(CommandBehavior.CloseConnection);
        }

        /// <summary>
        /// 執行一個查詢，返回一個數據集(DataTable)。
        /// </summary>
        public static DataTable GetDataSet(string sql, SqlParameter[] parameters = null)
        {
            using (SqlConnection conn = new SqlConnection(connectionString))
            {
                using (SqlCommand cmd = new SqlCommand(sql, conn))
                {
                    if (parameters != null)
                    {
                        cmd.Parameters.AddRange(parameters);
                    }

                    using (SqlDataAdapter da = new SqlDataAdapter(cmd))
                    {
                        DataTable dt = new DataTable();
                        da.Fill(dt);
                        return dt;
                    }
                }
            }
        }

        /// <summary>
        /// 執行一個命令(Insert, Update, Delete)，返回受影響的行數。
        /// </summary>
        public static int ExecuteCommand(string sql, SqlParameter[] parameters = null)
        {
            using (SqlConnection conn = new SqlConnection(connectionString))
            {
                using (SqlCommand cmd = new SqlCommand(sql, conn))
                {
                    if (parameters != null)
                    {
                        cmd.Parameters.AddRange(parameters);
                    }

                    conn.Open();
                    return cmd.ExecuteNonQuery();
                }
            }
        }
    }
}

三、DBHelper類的使用

1. 插入新數據

當我們需要向數據庫中插入新記錄時，可以使用ExecuteCommand方法。這個方法返回受影響的行數，從而讓我們知道插入操作是否成功。

string insertSql = "INSERT INTO Users (UserName, Password) VALUES (@UserName, @Password)";
SqlParameter[] insertParams = {
    new SqlParameter("@UserName", SqlDbType.VarChar, 50) { Value = "JohnDoe" },
    new SqlParameter("@Password", SqlDbType.VarChar, 50) { Value = "SecretPassword" }
};
int rowsAffected = DBHelper.ExecuteCommand(insertSql, insertParams);

此代碼段向數據庫的Users表中插入了一條新記錄，并返回插入操作影響的行數。

2. 條件更新數據

更新數據同樣可以通過ExecuteCommand方法來實現。以下示例展示了如何更新用戶的密碼。

string updateSql = "UPDATE Users SET Password = @Password WHERE UserName = @UserName";
SqlParameter[] updateParams = {
    new SqlParameter("@UserName", SqlDbType.VarChar, 50) { Value = "JohnDoe" },
    new SqlParameter("@Password", SqlDbType.VarChar, 50) { Value = "NewPassword" }
};
int rowsAffected = DBHelper.ExecuteCommand(updateSql, updateParams);

此代碼更新了用戶名為“JohnDoe”的用戶的密碼，并返回受影響的行數。

3. 刪除指定數據

通過ExecuteCommand方法，我們還可以刪除數據庫中的記錄。下面的示例展示了如何刪除某個用戶。

string deleteSql = "DELETE FROM Users WHERE UserName = @UserName";
SqlParameter[] deleteParams = {
    new SqlParameter("@UserName", SqlDbType.VarChar, 50) { Value = "JohnDoe" }
};
int rowsAffected = DBHelper.ExecuteCommand(deleteSql, deleteParams);

這段代碼刪除了用戶名為“JohnDoe”的用戶，并返回刪除操作影響的行數。

4. 獲取數據列表

DBHelper類還可以通過GetDataSet方法來返回一個包含查詢結果的數據集（DataTable）。這個方法在需要處理大量數據時非常有用。

string sql = "SELECT * FROM Users WHERE UserName LIKE @UserName";
SqlParameter[] parameters = {
    new SqlParameter("@UserName", SqlDbType.VarChar, 50) { Value = "%Doe%" }
};
DataTable users = DBHelper.GetDataSet(sql, parameters);

通過上面的代碼，我們可以獲取用戶名中包含“Doe”的所有用戶的詳細信息。

5. 獲取單一結果

在實際開發中，我們經常需要執行統計查詢，例如查詢用戶表中某個用戶名的記錄數。通過DBHelper類的GetScalar方法，我們可以輕松實現這一需求。

string sql = "SELECT COUNT(*) FROM Users WHERE UserName = @UserName";
SqlParameter[] parameters = {
    new SqlParameter("@UserName", SqlDbType.VarChar, 50) { Value = "JohnDoe" }
};
int userCount = DBHelper.GetScalar(sql, parameters);

上述代碼查詢了名為“JohnDoe”的用戶記錄數量，并返回查詢結果。

6. 逐行讀取數據

在某些情況下，我們可能只需要逐行處理查詢結果，而不需要將其全部加載到內存中。這時可以使用GetReader方法。

string sql = "SELECT UserName, Password FROM Users WHERE UserName = @UserName";
SqlParameter[] parameters = {
    new SqlParameter("@UserName", SqlDbType.VarChar, 50) { Value = "JohnDoe" }
};
using (SqlDataReader reader = DBHelper.GetReader(sql, parameters))
{
    while (reader.Read())
    {
        string userName = reader["UserName"].ToString();
        string password = reader["Password"].ToString();
        // 處理數據
    }
}

這段代碼逐行讀取用戶名為“JohnDoe”的用戶信息，并逐行處理結果。

四、DBHelper類的優勢

使用DBHelper類有以下幾個顯著優勢：

相比于其他類似的數據庫訪問層封裝工具，如Entity Framework和Dapper，DBHelper在靈活性和性能上具有一定優勢，特別適合那些對性能有較高要求并且需要直接控制SQL的場景。下表對比了DBHelper與其他常見ORM框架的特點：

五、總結

本文介紹了如何使用DBHelper類封裝數據庫操作，以提高代碼的可維護性和復用性。通過使用DBHelper類，開發者可以將注意力集中在業務邏輯上，而不是被繁瑣的數據庫操作細節所困擾。DBHelper在簡化數據庫操作的同時，也保證了較高的靈活性和性能，特別適合那些對數據庫操作有較高要求的項目。希望通過本文的介紹，您能夠掌握如何在項目中使用DBHelper類來簡化和優化數據庫操作，從而提升項目的開發效率和代碼質量。

通過引入DBHelper類，不僅可以減少代碼重復，提升開發效率，還能夠更好地維護和擴展項目中的數據庫操作邏輯。未來，您可以根據項目需求進一步擴展DBHelper類的功能，例如增加對事務的支持，或者集成更多的數據庫類型。