SqlHelper 带详细中文注释

  1 using System;  

  2 using System.Collections.Generic;  

  3 using System.Linq;  

  4 using System.Text;  

  5 //对数据库进行操作引入命名空间  

  6 using System.Data;  

  7 using System.Data.SqlClient;  

  8 using System.Configuration;  

  9   

 10   

 11 namespace DAL  

 12 {  

 13     public class SQLhelper  

 14     {  

 15   

 16   

 17         /// 变量定义<summary>  

 18         /// </summary>  

 19         private SqlConnection conn = null;  

 20         private SqlCommand cmd = null;      

 21         private SqlDataReader sdr = null;   

 22   

 23         /// SQLhelper connStr 字符串的连接<summary>  

 24         /// </summary>  

 25          04  011  

 26         public SQLhelper()  

 27         {  

 28             string connStr = ConfigurationManager.ConnectionStrings["connStr"].ConnectionString;  //连接SQL数据表

 29             conn = new SqlConnection(connStr);   //连接通道

 30   

 31         }  

 32   

 33   

 34   

 35         /// 获取conn<summary>  

 36         /// </summary>  

 37         /// <returns>为什么要这样写有什么意义呢？</returns>  

 38         private SqlConnection GetConn()  

 39         {  

 40             if (conn.State == ConnectionState.Closed)  //-判断当前连接的状态  如果当前的连接是关闭状态的话  结果为True 

 41             {  

 42                 conn.Open();   //-打开数据库

 43             }  

 44   

 45             return conn;    //返回结果

 46         }  

 47   

 48   

 49   

 50   

 51         /// 该方法传入一个增删改SQL语句或是存储过程<summary>  

 52         /// </summary>  

 53         /// <param name="sql">要执行的增删改SQL语句或是存储过程</param>  

 54         /// <returns>返回更新的记录数</returns>  

 55         public int ExecuteNonQuery(string cmdText,CommandType ct)  

 56         {  

 57             //-执行非查询 比如说 insert  Updata  Delect 

 58             //不定义的时候返回的初值是零  

 59             int res;  

 60             try  

 61             {  

 62                 //-1、将预见可能引发异常的代码包含在try语句块中。  

 63                 //-2、如果发生了异常，则转入catch的执行。

 64                 cmd = new SqlCommand(cmdText, GetConn());  

 65 

 66                 cmd.CommandType = ct;  

 67                 res = cmd.ExecuteNonQuery();  

 68             }  

 69             catch (Exception ex)  

 70             {  

 71                   //-这将捕获任何发生的异常。另外，还提供e参数，你可以在处理异常时使用e参数来获得有关异常的信息。

 72                 throw ex;  

 73             }  

 74             finally  

 75             {  

 76                 //-不管什么情况都会执行，包括try catch 里面用了return ,可以理解为只要执行了try或者catch，就一定会执行 finally 

 77                 //-清理工作。如关闭数据库连接。

 78                 if (conn.State == ConnectionState.Open)  

 79                 {  

 80                     conn.Close();  

 81                 }  

 82   

 83             }  

 84             return res;    //-返回给调用者

 85         }  

 86   

 87  

 88         /// 执行带参数的增删改语句或是存储过程<summary>  

 89         /// 执行带参数的增删改语句或是存储过程  

 90         /// </summary>  

 91         /// <param name="sql">带参数的SQL语句或是存储过程</param>  

 92         /// <param name="paras">参数集合</param>  

 93         /// <returns></returns>  

 94   

 95         public int ExecuteNonQuery(string cmdText, SqlParameter[] paras,CommandType ct)  

 96         {  

 97             int res;  

 98             using (cmd = new SqlCommand(cmdText, GetConn()))  

 99             {  

100                 cmd.CommandType = ct;  

101                 cmd.Parameters.AddRange(paras);   //将每个查询出的数 添加到数组

102 

103                 res = cmd.ExecuteNonQuery();  

104             }  

105 

106             return res;  

107   

108         }  

109   

110   

111         /// 该方法传入一个查询SQL语句或是存储过程<summary>  

112         /// 该方法传入一个查询SQL语句或是存储过程  

113         /// </summary>  

114         /// <param name="cmtText">SQL查询语句或存储过程</param>  

115         /// <returns></returns>  

116         public DataTable ExecuteQuery(string cmtText,CommandType ct)  

117         {  

118             DataTable dt = new DataTable();  

119             cmd = new SqlCommand(cmtText, GetConn());  

120             cmd.CommandType = ct;  

121             //关系sdr的同是将会关闭conn  

122             using (sdr = cmd.ExecuteReader(CommandBehavior.CloseConnection))  

123             {  

124                 dt.Load(sdr);  

125             }  

126             return dt;  

127         }  

128   

129   

130         /// 执行带参数的SQL语句或是存储过程<summary>  

131         /// 执行带参数的SQL语句或是存储过程  

132         /// </summary>  

133         /// <param name="cmdText">SQL语句或是存储过程</param>  

134         /// <param name="paras"></param>  

135         /// <returns></returns>  

136         public DataTable ExecuteQuery(string cmdText, SqlParameter[] paras,CommandType ct)  

137         {  

138             DataTable dt = new DataTable();  

139 

140             cmd = new SqlCommand(cmdText, GetConn());  

141             cmd.CommandType = ct;  

142             cmd.Parameters.AddRange(paras);  

143             //关系sdr的同是将会关闭conn  

144             using (sdr = cmd.ExecuteReader(CommandBehavior.CloseConnection))  

145             {  

146                 dt.Load(sdr);  

147             }  

148             return dt;  

149         }  

150 

151     }  

152 

153 }