C#SqlHelper类

使用C#编写SqlHelper类

无聊的周末，学习、编码无力。想找点事干但又不知道干点什么，猛然发现自己学过的SqlHelper快忘记了。于是乎虎躯一震心想怎能如此堕落下去，立马打开电脑，双手摸上键盘。写下此文作为学习过程中的复习，并分享出知识(顺便打发时间-^.^-)。

下面开始正文

这里以控制台程序为案例。首先我们需要先配置一下连接字符串,我们需要在app.config文件中增加如下节点:

1   <connectionStrings>
2     <add name="Sql" connectionString="server=数据库地址;uid=用户名;pwd=密码;database=数据库名"/>
3   </connectionStrings>

1.接着需要创建一个名为SqlHepler类，然后创建一个方法来获取app.config文件中配置的连接字符串。

1 public static string GetSqlConnectionString()
2 {
3     return ConfigurationManager.
4         ConnectionStrings["Sql"].ConnectionString;
5 }

2.下面来封装第一个SqlHepler方法，封装一个执行的sql 返回受影响的行数。

 1 public static int ExecuteNonQuery(string sqlText,params SqlParameter[] parameters)
 2 {
 3      using (SqlConnection conn = new SqlConnection(GetSqlConnectionString()))　　
 4      {
 5           using (SqlCommand cmd=conn.CreateCommand())
 6           {
 7               conn.Open();　　//打开数据库
 8               cmd.CommandText = sqlText;　　//对CommandText进行赋值
 9               cmd.Parameters.AddRange(parameters);　　//对数据库使用参数进行赋值
10               return cmd.ExecuteNonQuery();
11           }
12       }
13 }

参数说明:sqlText:需要执行的sql脚本，parameters:需要的参数集合

该方法主要是用于执行，删除、更新和插入操作，返回受影响的行数。

3.继续封装一个查询操作，返回查询结果中的第一行第一列的值

 1 public static object ExecuteScalar(string sqlText, params SqlParameter[] parameters)
 2{
 3    using (SqlConnection conn=new SqlConnection(GetSqlConnectionString()))
 4    {
 5       using (SqlCommand cmd=conn.CreateCommand())
 6       {
 7           conn.Open();
 8           cmd.CommandText = sqlText;
 9           cmd.Parameters.AddRange(parameters);
10           return cmd.ExecuteScalar();
11       }
12     }
13}

参数说明:如上。

该方法的返回值第object,所以当我们查询的数据不知道是什么类型的时候可以使用该类。

4.在封装个常用的查询方法，返回一个DataTable

 1 public static DataTable ExecuteDataTable(string sqlText, params SqlParameter[] parameters) 
 2{
 3     using (SqlDataAdapter adapter =new SqlDataAdapter(sqlText,GetSqlConnectionString()))
 4     {
 5         DataTable dt = new DataTable();
 6         adapter.SelectCommand.Parameters.AddRange(parameters);
 7         adapter.Fill(dt);
 8         return dt;
 9      }
10}

参数说明:如上。

 该方法主要用于一些查询数据，dt将被填充查询出来的数据，然后返回数据。

5.最后在写封装一个查询方法,该方法返回的是一个SqlDataReader类型

 1 public static SqlDataReader ExecuteReader(string sqlText, params SqlParameter[] parameters)
 2 {
 3       //SqlDataReader要求，它读取数据的时候有，它独占它的SqlConnection对象，而且SqlConnection必须是Open状态
 4       SqlConnection conn = new SqlConnection(GetSqlConnectionString());//不要释放连接，因为后面还需要连接打开状态
 5       SqlCommand cmd = conn.CreateCommand();
 6       conn.Open();
 7       cmd.CommandText = sqlText;
 8       cmd.Parameters.AddRange(parameters);
 9       //CommandBehavior.CloseConnection当SqlDataReader释放的时候，顺便把SqlConnection对象也释放掉
10       return cmd.ExecuteReader(CommandBehavior.CloseConnection);  
11 }

参数说明:依旧如上。

该方法返回的SqlDataReader 类型对象需要一直使用SqlConnection对象，所以不能释放。该类型读取数据是一行一行的读取。读取使用的是该类的Read()方法，返回值为bool判断数据是否为空(也就是是否读取到最后一行)，该方法将自动读取下到下一条记录。

作为一个初学者，本次只是简单的介绍，并复习了一下SqlHepler类。

附上全部代码：

 1 using System.Configuration;
 2 using System.Data;
 3 using System.Data.SqlClient;
 4 
 5 namespace UserInfoMgr
 6 {
 7     class SqlHelper
 8     {
 9         /// <summary>
10         /// 获取连接字符串
11         /// </summary>
12         /// <returns>连接字符串</returns>
13         public static string GetSqlConnectionString()
14         {
15             return ConfigurationManager.ConnectionStrings["Sql"].ConnectionString;
16         }
17 
18         /// <summary>
19         /// 封装一个执行的sql 返回受影响的行数
20         /// </summary>
21         /// <param name="sqlText">执行的sql脚本</param>
22         /// <param name="parameters">参数集合</param>
23         /// <returns>受影响的行数</returns>
24         public static int ExecuteNonQuery(string sqlText,params SqlParameter[] parameters)
25         {
26             using (SqlConnection conn = new SqlConnection(GetSqlConnectionString()))
27             {
28                 using (SqlCommand cmd=conn.CreateCommand())
29                 {
30                     conn.Open();
31                     cmd.CommandText = sqlText;
32                     cmd.Parameters.AddRange(parameters);
33                     return cmd.ExecuteNonQuery();
34                 }
35             }
36         }
37 
38         /// <summary>
39         /// 执行sql，返回查询结果中的第一行第一列的值
40         /// </summary>
41         /// <param name="sqlText">执行的sql脚本</param>
42         /// <param name="parameters">参数集合</param>
43         /// <returns>查询结果中的第一行第一列的值</returns>
44         public static object ExecuteScalar(string sqlText, params SqlParameter[] parameters)
45         {
46             using (SqlConnection conn=new SqlConnection(GetSqlConnectionString()))
47             {
48                 using (SqlCommand cmd=conn.CreateCommand())
49                 {
50                     conn.Open();
51                     cmd.CommandText = sqlText;
52                     cmd.Parameters.AddRange(parameters);
53                     return cmd.ExecuteScalar();
54                 }
55             }
56         }
57 
58         /// <summary>
59         /// 执行sql 返回一个DataTable
60         /// </summary>
61         /// <param name="sqlText">执行的sql脚本</param>
62         /// <param name="parameters">参数集合</param>
63         /// <returns>返回一个DataTable</returns>
64         public static DataTable ExecuteDataTable(string sqlText, params SqlParameter[] parameters) 
65         {
66             using (SqlDataAdapter adapter =new SqlDataAdapter(sqlText,GetSqlConnectionString()))
67             {
68                 DataTable dt = new DataTable();
69                 adapter.SelectCommand.Parameters.AddRange(parameters);
70                 adapter.Fill(dt);
71                 return dt;
72             }
73         }
74 
75         /// <summary>
76         /// 执行sql脚本
77         /// </summary>
78         /// <param name="sqlText">执行的sql脚本</param>
79         /// <param name="parameters">参数集合</param>
80         /// <returns>返回一个SqlDataReader</returns>
81         public static SqlDataReader ExecuteReader(string sqlText, params SqlParameter[] parameters)
82         {
83             //SqlDataReader要求，它读取数据的时候有，它独占它的SqlConnection对象，而且SqlConnection必须是Open状态
84             SqlConnection conn = new SqlConnection(GetSqlConnectionString());//不要释放连接，因为后面还需要连接打开状态
85             SqlCommand cmd = conn.CreateCommand();
86             conn.Open();
87             cmd.CommandText = sqlText;
88             cmd.Parameters.AddRange(parameters);
89             //CommandBehavior.CloseConnection当SqlDataReader释放的时候，顺便把SqlConnection对象也释放掉
90             return cmd.ExecuteReader(CommandBehavior.CloseConnection);  
91         }
92     }
93 }