C#编写SqlHelper类

 更新时间:2017年09月24日 15:49:09   作者:AMortal  
在C#中使用ADO.NET连接数据库的时候,每次连接都要编写连接,打开,执行SQL语句的代码,很麻烦,编写一个SqlHelper类,把每次连接都要写的代码封装成方法,把要执行的SQL语句通过参数传进去,可以大大简化编码

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

下面开始正文

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

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

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

 public static string GetSqlConnectionString()
 {
 return ConfigurationManager.
  ConnectionStrings["Sql"].ConnectionString;
 }

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

 public static int ExecuteNonQuery(string sqlText,params SqlParameter[] parameters)
 {
 using (SqlConnection conn = new SqlConnection(GetSqlConnectionString()))  
 {
  using (SqlCommand cmd=conn.CreateCommand())
  {
  conn.Open();  //打开数据库
  cmd.CommandText = sqlText;  //对CommandText进行赋值
  cmd.Parameters.AddRange(parameters);  //对数据库使用参数进行赋值
  return cmd.ExecuteNonQuery();
  }
 }
 }

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

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

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

 public static object ExecuteScalar(string sqlText, params SqlParameter[] parameters)
{
 using (SqlConnection conn=new SqlConnection(GetSqlConnectionString()))
 {
 using (SqlCommand cmd=conn.CreateCommand())
 {
  conn.Open();
  cmd.CommandText = sqlText;
  cmd.Parameters.AddRange(parameters);
  return cmd.ExecuteScalar();
 }
 }
}

参数说明:如上。

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

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

 public static DataTable ExecuteDataTable(string sqlText, params SqlParameter[] parameters) 
{
 using (SqlDataAdapter adapter =new SqlDataAdapter(sqlText,GetSqlConnectionString()))
 {
  DataTable dt = new DataTable();
  adapter.SelectCommand.Parameters.AddRange(parameters);
  adapter.Fill(dt);
  return dt;
 }
}

参数说明:如上。

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

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

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

参数说明:依旧如上。

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

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

附上全部代码:

 using System.Configuration;
 using System.Data;
 using System.Data.SqlClient;
 
 namespace UserInfoMgr
 {
 class SqlHelper
 {
  /// <summary>
  /// 获取连接字符串
  /// </summary>
  /// <returns>连接字符串</returns>
  public static string GetSqlConnectionString()
  {
  return ConfigurationManager.ConnectionStrings["Sql"].ConnectionString;
  }
 
  /// <summary>
  /// 封装一个执行的sql 返回受影响的行数
  /// </summary>
  /// <param name="sqlText">执行的sql脚本</param>
  /// <param name="parameters">参数集合</param>
  /// <returns>受影响的行数</returns>
  public static int ExecuteNonQuery(string sqlText,params SqlParameter[] parameters)
  {
  using (SqlConnection conn = new SqlConnection(GetSqlConnectionString()))
  {
   using (SqlCommand cmd=conn.CreateCommand())
   {
   conn.Open();
   cmd.CommandText = sqlText;
   cmd.Parameters.AddRange(parameters);
   return cmd.ExecuteNonQuery();
   }
  }
  }
 
  /// <summary>
  /// 执行sql,返回查询结果中的第一行第一列的值
  /// </summary>
  /// <param name="sqlText">执行的sql脚本</param>
  /// <param name="parameters">参数集合</param>
  /// <returns>查询结果中的第一行第一列的值</returns>
  public static object ExecuteScalar(string sqlText, params SqlParameter[] parameters)
  {
  using (SqlConnection conn=new SqlConnection(GetSqlConnectionString()))
  {
   using (SqlCommand cmd=conn.CreateCommand())
   {
   conn.Open();
   cmd.CommandText = sqlText;
   cmd.Parameters.AddRange(parameters);
   return cmd.ExecuteScalar();
   }
  }
  }
 
  /// <summary>
  /// 执行sql 返回一个DataTable
  /// </summary>
  /// <param name="sqlText">执行的sql脚本</param>
  /// <param name="parameters">参数集合</param>
  /// <returns>返回一个DataTable</returns>
  public static DataTable ExecuteDataTable(string sqlText, params SqlParameter[] parameters) 
  {
  using (SqlDataAdapter adapter =new SqlDataAdapter(sqlText,GetSqlConnectionString()))
  {
   DataTable dt = new DataTable();
   adapter.SelectCommand.Parameters.AddRange(parameters);
   adapter.Fill(dt);
   return dt;
  }
  }
 
  /// <summary>
  /// 执行sql脚本
  /// </summary>
  /// <param name="sqlText">执行的sql脚本</param>
  /// <param name="parameters">参数集合</param>
  /// <returns>返回一个SqlDataReader</returns>
  public static SqlDataReader ExecuteReader(string sqlText, params SqlParameter[] parameters)
  {
  //SqlDataReader要求,它读取数据的时候有,它独占它的SqlConnection对象,而且SqlConnection必须是Open状态
  SqlConnection conn = new SqlConnection(GetSqlConnectionString());//不要释放连接,因为后面还需要连接打开状态
  SqlCommand cmd = conn.CreateCommand();
  conn.Open();
  cmd.CommandText = sqlText;
  cmd.Parameters.AddRange(parameters);
  //CommandBehavior.CloseConnection当SqlDataReader释放的时候,顺便把SqlConnection对象也释放掉
  return cmd.ExecuteReader(CommandBehavior.CloseConnection); 
  }
 }
 }

再给大家分享一个sqlhelper类

using System;
using System.Collections.Generic;
using System.Configuration;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Data.SqlClient;
using System.Data;
namespace ADONET2
{
 class SqlHelper
 {

 //封装方法的原则,把不变的放在方法中,把变化的放在参数中传进来

 private static string connStr = ConfigurationManager.ConnectionStrings["dbConn"].ConnectionString;

 //public static int ExecuteNonQuery(string sql)
 //{
 // using (SqlConnection conn = new SqlConnection(connStr))
 // {
 // conn.Open();
 // using (SqlCommand cmd = conn.CreateCommand())
 // {
 //  cmd.CommandText = sql;

 //  return cmd.ExecuteNonQuery();
 // }
 // }
 //}

 //public static object ExecuteScalar(string sql)
 //{
 // using (SqlConnection conn = new SqlConnection(connStr))
 // {
 // conn.Open();

 // using (SqlCommand cmd = conn.CreateCommand())
 // {
 //  cmd.CommandText = sql;

 //  return cmd.ExecuteScalar();
 // }
 // }
 //}

 //public static DataTable ExecuteDataTable(string sql)
 //{
 // using (SqlConnection conn = new SqlConnection(connStr))
 // {
 // conn.Open();
 // using (SqlCommand cmd = conn.CreateCommand())
 // {
 //  cmd.CommandText = sql;
 //  SqlDataAdapter adapter = new SqlDataAdapter(cmd);
 //  DataSet dataset = new DataSet();

 //  adapter.Fill(dataset);

 //  return dataset.Tables[0];
 // }
 // }
 //}

 public static int ExecuteNonQuery(string sql,params SqlParameter[] parameters)
 {
  using (SqlConnection conn = new SqlConnection(connStr))
  {
  conn.Open();
  using (SqlCommand cmd = conn.CreateCommand())
  {
   cmd.CommandText = sql;

   //foreach (SqlParameter param in parameters)
   //{
   // cmd.Parameters.Add(param);
   //}
   cmd.Parameters.AddRange(parameters);
   return cmd.ExecuteNonQuery();
  }
  }
 }

 public static object ExecuteScalar(string sql,SqlParameter[] parameters)
 {
  using (SqlConnection conn = new SqlConnection(connStr))
  {
  conn.Open();

  using (SqlCommand cmd = conn.CreateCommand())
  {
   cmd.CommandText = sql;
   cmd.Parameters.AddRange(parameters);

   return cmd.ExecuteScalar();
  }
  }
 }

 //public static DataTable ExecuteDataTable(string sql,SqlParameter[] parameters)
 //{
 // using (SqlConnection conn = new SqlConnection(connStr))
 // {
 // conn.Open();
 // using (SqlCommand cmd = conn.CreateCommand())
 // {
 //  cmd.CommandText = sql;
 //  cmd.Parameters.AddRange(parameters);
 //  SqlDataAdapter adapter = new SqlDataAdapter(cmd);
 //  DataSet dataset = new DataSet();
 //  adapter.Fill(dataset);
 //  return dataset.Tables[0];
 // }
 // }
 //}

 //使用可变参数
 public static DataTable ExecuteDataTable(string sql, params SqlParameter[] parameters)
 {
  using (SqlConnection conn = new SqlConnection(connStr))
  {
  conn.Open();
  using (SqlCommand cmd = conn.CreateCommand())
  {
   cmd.CommandText = sql;
   cmd.Parameters.AddRange(parameters);
   SqlDataAdapter adapter = new SqlDataAdapter(cmd);
   DataSet dataset = new DataSet();
   adapter.Fill(dataset);
   return dataset.Tables[0];
  }
  }
 }
 }
}

相关文章

  • C#索引属性用法实例分析

    C#索引属性用法实例分析

    这篇文章主要介绍了C#索引属性用法,实例分析了C#声明索引属性的相关技巧,需要的朋友可以参考下
    2015-06-06
  • 举例讲解C#编程中对设计模式中的单例模式的运用

    举例讲解C#编程中对设计模式中的单例模式的运用

    这篇文章主要介绍了C#编程中对设计模式中的单例模式的运用,单例模式在.NET框架的相关开发中也被经常用到,需要的朋友可以参考下
    2016-02-02
  • C#操作DataTable的实现步骤

    C#操作DataTable的实现步骤

    本文主要介绍了C#操作DataTable的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-04-04
  • C#实现访问Web API Url提交数据并获取处理结果

    C#实现访问Web API Url提交数据并获取处理结果

    Web API  是 Web 服务器和 Web 浏览器之间的应用程序处理接口,我们常见的模式是访问 Web API Url 地址,并获取 Json 、XML或其它指定格式的处理结果, 本文我们介绍了使用C#实现访问Web API Url提交数据并获取处理结果,需要的朋友可以参考下
    2024-05-05
  • 浅析C#中goto跳转语句的用法

    浅析C#中goto跳转语句的用法

    在我们日常工作中常用的C#跳转语句有break、continue、return,但是还有一个C#跳转语句很多同学可能都比较的陌生就是goto,下面我们就来看看goto跳转语句的用法吧
    2024-03-03
  • C#实现泛型List分组输出元素的方法

    C#实现泛型List分组输出元素的方法

    这篇文章主要介绍了C#实现泛型List分组输出元素的方法,涉及C#针对List的遍历、排序、输出等相关操作技巧,需要的朋友可以参考下
    2017-12-12
  • 详解如何实现C#和Python间实时视频数据交互

    详解如何实现C#和Python间实时视频数据交互

    我们在做RTSP|RTMP播放的时候,遇到好多开发者,他们的视觉算法大多运行在python下,需要高效率的实现C#和Python的视频数据交互,本文给大家总结了一些常用的方法,感兴趣的小伙伴跟着小编一起来看看吧
    2024-10-10
  • 让C# Excel导入导出 支持不同版本Office

    让C# Excel导入导出 支持不同版本Office

    让C# Excel导入导出,支持不同版本的Office,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-08-08
  • 分享我在工作中遇到的多线程下导致RCW无法释放的问题

    分享我在工作中遇到的多线程下导致RCW无法释放的问题

    最近在做项目中遇到一个问题,在调用一个类库中的方法时,出现如下异常信息:尝试释放正在使用的RCW,活动线程或其他线程上正在使用该 RCW,释放正在使用的 RCW 的尝试会导致损坏或数据丢失
    2015-12-12
  • C#实现图表中鼠标移动并显示数据

    C#实现图表中鼠标移动并显示数据

    这篇文章主要为大家详细介绍了C#实现图表中鼠标移动并显示数据,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-02-02

最新评论