SqlHelper 带详细中文注释

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
//对数据库进行操作引入命名空间  
using System.Data;  
using System.Data.SqlClient;  
using System.Configuration;  
  
  
namespace DAL  
{  
    public class SQLhelper  
    {  
  
  
        /// 变量定义<summary>  
        /// </summary>  
        private SqlConnection conn = null;  
        private SqlCommand cmd = null;      
        private SqlDataReader sdr = null;   
  
        /// SQLhelper connStr 字符串的连接<summary>  
        /// </summary>  
         04  011  
        public SQLhelper()  
        {  
            string connStr = ConfigurationManager.ConnectionStrings["connStr"].ConnectionString;  //连接SQL数据表
            conn = new SqlConnection(connStr);   //连接通道
  
        }  
  
  
  
        /// 获取conn<summary>  
        /// </summary>  
        /// <returns>为什么要这样写有什么意义呢？</returns>  
        private SqlConnection GetConn()  
        {  
            if (conn.State == ConnectionState.Closed)  //-判断当前连接的状态  如果当前的连接是关闭状态的话  结果为True 
            {  
                conn.Open();   //-打开数据库
            }  
  
            return conn;    //返回结果
        }  
  
  
  
  
        /// 该方法传入一个增删改SQL语句或是存储过程<summary>  
        /// </summary>  
        /// <param name="sql">要执行的增删改SQL语句或是存储过程</param>  
        /// <returns>返回更新的记录数</returns>  
        public int ExecuteNonQuery(string cmdText,CommandType ct)  
        {  
            //-执行非查询 比如说 insert  Updata  Delect 
            //不定义的时候返回的初值是零  
            int res;  
            try  
            {  
                //-1、将预见可能引发异常的代码包含在try语句块中。  
                //-2、如果发生了异常，则转入catch的执行。
                cmd = new SqlCommand(cmdText, GetConn());  

                cmd.CommandType = ct;  
                res = cmd.ExecuteNonQuery();  
            }  
            catch (Exception ex)  
            {  
                  //-这将捕获任何发生的异常。另外，还提供e参数，你可以在处理异常时使用e参数来获得有关异常的信息。
                throw ex;  
            }  
            finally  
            {  
                //-不管什么情况都会执行，包括try catch 里面用了return ,可以理解为只要执行了try或者catch，就一定会执行 finally 
                //-清理工作。如关闭数据库连接。
                if (conn.State == ConnectionState.Open)  
                {  
                    conn.Close();  
                }  
  
            }  
            return res;    //-返回给调用者
        }  
  
 
        /// 执行带参数的增删改语句或是存储过程<summary>  
        /// 执行带参数的增删改语句或是存储过程  
        /// </summary>  
        /// <param name="sql">带参数的SQL语句或是存储过程</param>  
        /// <param name="paras">参数集合</param>  
        /// <returns></returns>  
  
        public int ExecuteNonQuery(string cmdText, SqlParameter[] paras,CommandType ct)  
        {  
            int res;  
            using (cmd = new SqlCommand(cmdText, GetConn()))  
            {  
                cmd.CommandType = ct;  
                cmd.Parameters.AddRange(paras);   //将每个查询出的数 添加到数组

                res = cmd.ExecuteNonQuery();  
            }  

            return res;  
  
        }  
  
  
        /// 该方法传入一个查询SQL语句或是存储过程<summary>  
        /// 该方法传入一个查询SQL语句或是存储过程  
        /// </summary>  
        /// <param name="cmtText">SQL查询语句或存储过程</param>  
        /// <returns></returns>  
        public DataTable ExecuteQuery(string cmtText,CommandType ct)  
        {  
            DataTable dt = new DataTable();  
            cmd = new SqlCommand(cmtText, GetConn());  
            cmd.CommandType = ct;  
            //关系sdr的同是将会关闭conn  
            using (sdr = cmd.ExecuteReader(CommandBehavior.CloseConnection))  
            {  
                dt.Load(sdr);  
            }  
            return dt;  
        }  
  
  
        /// 执行带参数的SQL语句或是存储过程<summary>  
        /// 执行带参数的SQL语句或是存储过程  
        /// </summary>  
        /// <param name="cmdText">SQL语句或是存储过程</param>  
        /// <param name="paras"></param>  
        /// <returns></returns>  
        public DataTable ExecuteQuery(string cmdText, SqlParameter[] paras,CommandType ct)  
        {  
            DataTable dt = new DataTable();  

            cmd = new SqlCommand(cmdText, GetConn());  
            cmd.CommandType = ct;  
            cmd.Parameters.AddRange(paras);  
            //关系sdr的同是将会关闭conn  
            using (sdr = cmd.ExecuteReader(CommandBehavior.CloseConnection))  
            {  
                dt.Load(sdr);  
            }  
            return dt;  
        }  

    }  

}