SqlServerHelper類，整理微軟提供的helper

微軟在petShop中使用了SqlServerHelper類，通過調用靜態方法實現對數據庫的操作，使用起來非常簡單順手，下面整理了該類的代碼，並加以說明：

//------------------------------------------------------------
// All Rights Reserved , Copyright (C) 2010 , lusens 
//------------------------------------------------------------

using System;
using System.Collections.Generic;
using System.Text;
using System.Data;
using System.Data.SqlClient;

namespace Utility.Data
{
    /// <summary>
    /// SQLServer數據庫操作類
    /// 本類主要包括SQLServer數據庫的基本操作
    /// 
    /// 修改紀錄
    /// 
    ///     2010.10.22 版本：1.1 lusens 新增了用戶傳入sql語句列表的事務操作
    ///		2010.09.05 版本：1.0 lusens 創建。
    /// 
    /// 版本：1.1
    /// 
    /// <author>
    ///		<name>lusens</name>
    ///		<date>2010.09.05</date>
    ///		<EMail>[email protected]</EMail>
    /// </author> 
    /// </summary>
    public abstract class SQLServerHepler
    {
        //public static readonly string ConnectionString = System.Configuration.ConfigurationManager.ConnectionStrings["SQLConnString"].ConnectionString;

        #region public static string GetConnectionStringByConfig()
        /// <summary>
        /// 讀取配置文件的ConnectionString字符串
        /// </summary>
        /// <returns>Connection連接字符串</returns>
        public static string GetConnectionStringByConfig()
        {
            return System.Configuration.ConfigurationManager.ConnectionStrings["SQLConnString"].ConnectionString;
        }
        #endregion

        #region 執行SQL，返回被操作的行數,public static int ExecuteNonQuery(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)

        /// <summary>
        /// 執行SQL語句，返回被操作的行數
        /// 使用using語句進行conn對象的釋放
        /// </summary>
        /// <param name="connectionString">連接字符</param>
        /// <param name="cmdType">Command類型，SQL語句或存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns>返回被操作行數</returns>
        public static int ExecuteNonQuery(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            SqlCommand cmd = new SqlCommand();
            using (SqlConnection conn = new SqlConnection(connectionString))
            {
                PrepareCommand(cmd, conn, null, cmdType, cmdText, commandParameters);
                int val = cmd.ExecuteNonQuery();
                cmd.Parameters.Clear();
                return val;
            }
        }
        #endregion

        #region 執行SQL，返回被操作的行數,public static int ExecuteNonQuery(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 執行SQL語句，返回被操作的行數
        /// 這裏默認使用外面傳入的conn對象，使用完成後不會對conn對象進行釋放，需要自己在外面進行數據庫連接釋放
        /// </summary>
        /// <param name="connection">數據庫連接對象</param>
        /// <param name="cmdType">command命令類型，SQL語句或存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static int ExecuteNonQuery(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            SqlCommand cmd = new SqlCommand();
            PrepareCommand(cmd, connection, null, cmdType, cmdText, commandParameters);
            int val = cmd.ExecuteNonQuery();
            cmd.Parameters.Clear();
            return val;
        }
        #endregion

        #region 執行SQL語句，返回被操作的行數,public static int ExecuteNonQuery(SqlTransaction trans, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 執行SQL語句，返回被操作的行數
        /// 這裏默認使用外面傳入的conn對象，使用完成後不會對conn對象進行釋放，需要自己在外面進行數據庫連接釋放
        /// </summary>
        /// <param name="trans">SQL事務</param>
        /// <param name="cmdType">command類型，SQL語句或存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static int ExecuteNonQuery(SqlTransaction trans, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            SqlCommand cmd = new SqlCommand();
            PrepareCommand(cmd, trans.Connection, trans, cmdType, cmdText, commandParameters);
            int val = cmd.ExecuteNonQuery();
            cmd.Parameters.Clear();
            return val;
        }

        #endregion

        #region 執行SQL，返回SqlDataReader,public static SqlDataReader ExecuteReader(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 執行SQL，返回SqlDataReader
        /// 返回一個連接，所以不能進行conn釋放，在外界代碼中使用完DataReader後，注意需要釋放reader對象
        /// 當返回連接對象報錯時，這裏進行數據庫連接的關閉，保證數據庫連接使用完成後保持關閉
        /// </summary>
        /// <param name="connectionString">數據庫連接字符串</param>
        /// <param name="cmdType">command命令類型，SQL語句或存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static SqlDataReader ExecuteReader(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            SqlCommand cmd = new SqlCommand();
            SqlConnection conn = new SqlConnection(connectionString);

            try
            {
                PrepareCommand(cmd, conn, null, cmdType, cmdText, commandParameters);
                SqlDataReader rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection);
                cmd.Parameters.Clear();
                return rdr;
            }
            catch (Exception e)
            {
                conn.Close();
                throw e;
            }
        }
        #endregion

        #region 執行SQL，返回SqlDataReader, public static SqlDataReader ExecuteReader(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 執行SQL，返回SqlDataReader
        /// 返回一個連接，所以不能進行conn釋放，在外界代碼中使用完DataReader後，注意需要釋放reader對象
        /// 當返回連接對象報錯時，這裏進行數據庫連接的關閉，保證數據庫連接使用完成後保持關閉
        /// </summary>
        /// <param name="connection">SqlConnection數據庫連接對象</param>
        /// <param name="cmdType">command命令類型，SQL語句或存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static SqlDataReader ExecuteReader(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            SqlCommand cmd = new SqlCommand();

            try
            {
                PrepareCommand(cmd, connection, null, cmdType, cmdText, commandParameters);
                SqlDataReader rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection);
                cmd.Parameters.Clear();
                return rdr;
            }
            catch (Exception e)
            {
                connection.Close();
                throw e;
            }
        }
        #endregion

        #region 執行SQL，返回DataTable， public static DataTable ExecuteDataTable(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 執行SQL，返回DataTable
        /// 使用using語句進行conn對象的釋放
        /// </summary>
        /// <param name="connectionString">數據庫連接字符串</param>
        /// <param name="cmdType">command命令類型，SQL語句或存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static DataTable ExecuteDataTable(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            DataTable dt = new DataTable();
            SqlCommand cmd = new SqlCommand();

            using (SqlConnection conn = new SqlConnection(connectionString))
            {
                PrepareCommand(cmd, conn, null, cmdType, cmdText, commandParameters);
                using (SqlDataAdapter sda = new SqlDataAdapter())
                {
                    sda.SelectCommand = cmd;
                    sda.Fill(dt);
                }
            }

            return dt;
        }
        #endregion

        #region 執行SQL，返回DataTable,public static DataTable ExecuteDataTable(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 執行SQL，返回DataTable
        /// 這裏默認使用外面傳入的conn對象，使用完成後不會對conn對象進行釋放，需要自己在外面進行數據庫連接釋放
        /// </summary>
        /// <param name="connection">數據庫連接對象</param>
        /// <param name="cmdType">Command命令類型，SQL語句或存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static DataTable ExecuteDataTable(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            DataTable dt = new DataTable();
            SqlCommand cmd = new SqlCommand();

            PrepareCommand(cmd, connection, null, cmdType, cmdText, commandParameters);
            using (SqlDataAdapter sda = new SqlDataAdapter())
            {
                sda.SelectCommand = cmd;
                sda.Fill(dt);
            }

            return dt;
        }
        #endregion

        #region 返回第一行第一列，public static object ExecuteScalar(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 返回第一行第一列
        /// 使用using語句進行conn對象的釋放
        /// </summary>
        /// <param name="connectionString">數據庫連接字符串</param>
        /// <param name="cmdType">Command命令類型，SQL語句還是存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static object ExecuteScalar(string connectionString, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            SqlCommand cmd = new SqlCommand();

            using (SqlConnection connection = new SqlConnection(connectionString))
            {
                PrepareCommand(cmd, connection, null, cmdType, cmdText, commandParameters);
                object val = cmd.ExecuteScalar();
                cmd.Parameters.Clear();
                return val;
            }
        }
        #endregion

        #region 返回第一行第一列，public static object ExecuteScalar(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        /// <summary>
        /// 返回第一行第一列
        /// 使用外面傳入的conn對象，使用完成後不會對conn對象進行釋放，需要自己在外面進行數據庫連接釋放
        /// </summary>
        /// <param name="connection">SqlConnection數據庫連接對象</param>
        /// <param name="cmdType">Command命令類型，SQL語句還是存儲過程</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="commandParameters">參數數組</param>
        /// <returns></returns>
        public static object ExecuteScalar(SqlConnection connection, CommandType cmdType, string cmdText, params SqlParameter[] commandParameters)
        {
            SqlCommand cmd = new SqlCommand();

            PrepareCommand(cmd, connection, null, cmdType, cmdText, commandParameters);
            object val = cmd.ExecuteScalar();
            cmd.Parameters.Clear();
            return val;
        }
        #endregion

        #region 以事務執行sql語句列表，public static bool ExecuteTransaction(SqlConnection conn, List<string> cmdTextes, List<SqlParameter[]> commandParameterses)
        /// <summary>
        /// 以事務執行sql語句列表，返回事務執行是否成功
        /// </summary>
        /// <param name="conn">數據庫連接對象</param>
        /// <param name="cmdTextes">sql語句列表</param>
        /// <param name="commandParameterses">sql語句列表對應的參數列表，參數列表必須與sql語句列表匹配</param>
        /// <returns>事務執行是否成功</returns>
        public static bool ExecuteTransaction(SqlConnection conn, List<string> cmdTextes, List<SqlParameter[]> commandParameterses)
        {
            bool flag = false;
            if (cmdTextes.Count == commandParameterses.Count)
            {
                SqlTransaction sqlTran = conn.BeginTransaction();
                try
                {
                    for (int i = 0; i < cmdTextes.Count; i++)
                    {
                        ExecuteNonQuery(sqlTran, CommandType.Text, cmdTextes[i], commandParameterses[i]);
                    }
                    sqlTran.Commit();
                    flag = true;
                }
                catch (Exception e)
                {
                    sqlTran.Rollback();
                }
            }
            return flag;
        }
        #endregion

        #region 以事務執行sql語句列表，返回事務執行是否成功，public static bool ExecuteTransaction(string connectionString, List<string> cmdTextes, List<SqlParameter[]> commandParameterses)
        /// <summary>
        /// 以事務執行sql語句列表，返回事務執行是否成功
        /// </summary>
        /// <param name="connectionString">數據庫連接字符串</param>
        /// <param name="cmdTextes">sql語句列表</param>
        /// <param name="commandParameterses">sql語句列表對應的參數列表，參數列表必須與sql語句列表匹配</param>
        /// <returns></returns>
        public static bool ExecuteTransaction(string connectionString, List<string> cmdTextes, List<SqlParameter[]> commandParameterses)
        {
            bool flag = false;
            if (cmdTextes.Count == commandParameterses.Count)
            {
                using (SqlConnection conn = new SqlConnection(connectionString))
                {
                    SqlTransaction sqlTran = conn.BeginTransaction();
                    try
                    {
                        for (int i = 0; i < cmdTextes.Count; i++)
                        {
                            ExecuteNonQuery(sqlTran, CommandType.Text, cmdTextes[i], commandParameterses[i]);
                        }
                        sqlTran.Commit();
                        flag = true;
                    }
                    catch (Exception e)
                    {
                        sqlTran.Rollback();
                    }
                }
            }
            return flag;
        }
        #endregion

        #region 構造SQLCommand,private static void PrepareCommand(SqlCommand cmd, SqlConnection conn, SqlTransaction trans, CommandType cmdType, string cmdText, SqlParameter[] cmdParms)
        /// <summary>
        /// 構造SQLCommand
        /// </summary>
        /// <param name="cmd">Command對象</param>
        /// <param name="conn">SqlConnection數據庫連接對象</param>
        /// <param name="trans">SQL事務</param>
        /// <param name="cmdType">Command命令類型</param>
        /// <param name="cmdText">SQL語句或存儲過程名稱</param>
        /// <param name="cmdParms">參數數組</param>
        private static void PrepareCommand(SqlCommand cmd, SqlConnection conn, SqlTransaction trans, CommandType cmdType, string cmdText, SqlParameter[] cmdParms)
        {
            if (conn.State != ConnectionState.Open)
                conn.Open();

            cmd.Connection = conn;
            cmd.CommandText = cmdText;

            if (trans != null)
                cmd.Transaction = trans;

            cmd.CommandType = cmdType;

            if (cmdParms != null)
            {
                foreach (SqlParameter parm in cmdParms)
                    cmd.Parameters.Add(parm);
            }
        }
        #endregion
    }
}

注意：該類並沒有完全封裝所有數據對象的使用 ，所以在外面使用類時，也會自行使用SqlConnection、SqlCommand等對象；

可以在 http://download.csdn.net/detail/luxin10/3830325 下載，無需積分