SQLHelper

　　这一篇，我们编写SQLHelper这个类的目的是为了封装对数据库的操作。

1.    封装方法的原则

　　　　把不变的代码写入方法中，把变化的部分通过参数传递

　　 　  不变的代码：连接数据、执行数据库操作的方法等

　　　　  变化的部分：SQL语句，进行参数化查询的时候需要传递的参数

2.    实现SQLHelper类

    //不声明为publc的目的：这个类只在程序集当中使用，不必对外。
    //尽可能地对外少暴露publc类
    class SQLHelper
    {
        //连接数据库的字符串
        private static string strConn = ConfigurationManager.ConnectionStrings["dbconStr"].ConnectionString;

        /// <summary>
        /// 执行非查询sql语句，如insert、delete、update
        /// </summary>
        /// <param name="sqlCmd">要执行的sql语句</param>
        /// <param name="parameters">sql语句中的参数</param>
        /// <returns>执行语句后，受到影响的行数</returns>
        public static int ExecuteNoQuery(string sqlCmd, params SqlParameter[] parameters) 
        {
            using (SqlConnection conn = new SqlConnection(strConn))
            {
                conn.Open();
                using (SqlCommand cmd = conn.CreateCommand()) 
                {
                    cmd.CommandText = sqlCmd;
                    cmd.Parameters.AddRange(parameters);
                    return cmd.ExecuteNonQuery();                      
                }
            }
        }

        /// <summary>
        /// 一般用于返回一个数据的查询数据，如查询一个学生的数学成绩
        /// </summary>
        /// <param name="sqlCmd">要执行的sql语句</param>
        /// <param name="parameters">sql语句中的参数</param>
        /// <returns>查询结果，object类型</returns>
        public static object ExecuteScalar(string sqlCmd, params SqlParameter[] parameters) 
        {
            using (SqlConnection conn = new SqlConnection(strConn)) 
            {
                conn.Open();
                using (SqlCommand cmd = conn.CreateCommand()) 
                {
                    cmd.CommandText = sqlCmd;
                    cmd.Parameters.AddRange(parameters);
                    return cmd.ExecuteScalar();
                }
            }
        }

        /// <summary>
        /// 将查询结果以DataSet的形式返回
        /// </summary>
        /// <param name="sqlCmd">要执行的sql语句</param>
        /// <param name="parameters">sql语句中的参数</param>
        /// <returns>数据集合，DataSet类型</returns>
        public static DataSet ExecuteDataSet(string sqlCmd, params SqlParameter[] parameters) 
        {
            using (SqlConnection conn = new SqlConnection(strConn)) 
            {
                conn.Open();
                using (SqlCommand cmd = conn.CreateCommand()) 
                {
                    cmd.CommandText = sqlCmd;
                    cmd.Parameters.AddRange(parameters);
                    SqlDataAdapter adpter = new SqlDataAdapter(cmd);
                    DataSet dataset = new DataSet();
                    adpter.Fill(dataset);
                    return dataset;
                }
            }
        }

        /// <summary>
        /// 执行查询结果数据量较大的查询语句，如查询1000个学生的信息
        /// </summary>
        /// <param name="sqlCmd">要执行的sql语句</param>
        /// <param name="parameters">sql语句中的参数</param>
        /// <returns>一个Staff类型的List</returns>
        public static List<Staff> ExecuteReader(string sqlCmd, params SqlParameter[] parameters) 
        {
            using (SqlConnection conn = new SqlConnection(strConn)) 
            {
                conn.Open();
                using (SqlCommand cmd = conn.CreateCommand()) 
                {
                    cmd.CommandText = sqlCmd;
                    cmd.Parameters.AddRange(parameters);

                    SqlDataReader reader = cmd.ExecuteReader();
                    List<Staff> lStaff = new List<Staff>();
                    while (reader.Read())
                    {
                        lStaff.Add(new Staff()
                        {
                            Name = (string)reader["Name"],
                            Age = (int)reader["Age"],
                            Sex = (bool)reader["Sex"],
                            Height = (decimal)reader["Height"],
                            Salary = (decimal)reader["Salary"],
                            //数据库中有些数据可以为空，如果使用强制转换的话，会出现错误
                            //应该使用as来转换
                            Department = reader["Department"] as string
                        });
                    }
                    return lStaff;
                }
            }
        }
    }

3.    调用SQLHelper类

            string sqlCmd = "insert into t_staff(Name,Age,Sex,Height,Salary) values('郑冰',27,1,1.64,3000)";
            SQLHelper.ExecuteNoQuery(sqlCmd);

            string sqlCmd = "select Salary from t_staff where id > 2";
            DataSet dataset = SQLHelper.ExecuteDataSet(sqlCmd);
            DataTable table = dataset.Tables[0]; 
            foreach(DataRow row in table.Rows)
            {
                MessageBox.Show(row[0].ToString() + " == " + row["Salary"].ToString());
            }

            string sqlCmd = "select Salary from t_staff where Name = @value";
            object salary = SQLHelper.ExecuteScalar(sqlCmd, new SqlParameter("@value", "马金"));
            MessageBox.Show(salary.ToString());

            string sqlCmd = "select * from t_staff";
            List<Staff> lStaff = SQLHelper.ExecuteReader(sqlCmd);