C#編寫SqlHelper類

更新時間：2017年09月24日 15:49:09 作者：AMortal

在C#中使用ADO.NET連接數(shù)據(jù)庫的時候，每次連接都要編寫連接，打開，執(zhí)行SQL語句的代碼，很麻煩，編寫一個SqlHelper類，把每次連接都要寫的代碼封裝成方法，把要執(zhí)行的SQL語句通過參數(shù)傳進去，可以大大簡化編碼

無聊的周末，學(xué)習(xí)、編碼無力。想找點事干但又不知道干點什么，猛然發(fā)現(xiàn)自己學(xué)過的SqlHelper快忘記了。于是乎虎軀一震心想怎能如此墮落下去，立馬打開電腦，雙手摸上鍵盤。寫下此文作為學(xué)習(xí)過程中的復(fù)習(xí)，并分享出知識(順便打發(fā)時間-^.^-)。

下面開始正文

這里以控制臺程序為案例。首先我們需要先配置一下連接字符串,我們需要在app.config文件中增加如下節(jié)點:

 <connectionStrings>
 <add name="Sql" connectionString="server=數(shù)據(jù)庫地址;uid=用戶名;pwd=密碼;database=數(shù)據(jù)庫名"/>
 </connectionStrings>

1.接著需要創(chuàng)建一個名為SqlHepler類，然后創(chuàng)建一個方法來獲取app.config文件中配置的連接字符串。

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

2.下面來封裝第一個SqlHepler方法，封裝一個執(zhí)行的sql 返回受影響的行數(shù)。

 public static int ExecuteNonQuery(string sqlText,params SqlParameter[] parameters)
 {
 using (SqlConnection conn = new SqlConnection(GetSqlConnectionString()))　　
 {
  using (SqlCommand cmd=conn.CreateCommand())
  {
  conn.Open();　　//打開數(shù)據(jù)庫
  cmd.CommandText = sqlText;　　//對CommandText進行賦值
  cmd.Parameters.AddRange(parameters);　　//對數(shù)據(jù)庫使用參數(shù)進行賦值
  return cmd.ExecuteNonQuery();
  }
 }
 }

參數(shù)說明:sqlText:需要執(zhí)行的sql腳本，parameters:需要的參數(shù)集合

該方法主要是用于執(zhí)行，刪除、更新和插入操作，返回受影響的行數(shù)。

3.繼續(xù)封裝一個查詢操作，返回查詢結(jié)果中的第一行第一列的值

 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();
 }
 }
}

參數(shù)說明:如上。

該方法的返回值第object,所以當(dāng)我們查詢的數(shù)據(jù)不知道是什么類型的時候可以使用該類。

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;
 }
}

參數(shù)說明:如上。

該方法主要用于一些查詢數(shù)據(jù)，dt將被填充查詢出來的數(shù)據(jù)，然后返回數(shù)據(jù)。

5.最后在寫封裝一個查詢方法,該方法返回的是一個SqlDataReader類型

 public static SqlDataReader ExecuteReader(string sqlText, params SqlParameter[] parameters)
 {
 //SqlDataReader要求，它讀取數(shù)據(jù)的時候有，它獨占它的SqlConnection對象，而且SqlConnection必須是Open狀態(tài)
 SqlConnection conn = new SqlConnection(GetSqlConnectionString());//不要釋放連接，因為后面還需要連接打開狀態(tài)
 SqlCommand cmd = conn.CreateCommand();
 conn.Open();
 cmd.CommandText = sqlText;
 cmd.Parameters.AddRange(parameters);
 //CommandBehavior.CloseConnection當(dāng)SqlDataReader釋放的時候，順便把SqlConnection對象也釋放掉
 return cmd.ExecuteReader(CommandBehavior.CloseConnection); 
 }

參數(shù)說明:依舊如上。

該方法返回的SqlDataReader 類型對象需要一直使用SqlConnection對象，所以不能釋放。該類型讀取數(shù)據(jù)是一行一行的讀取。讀取使用的是該類的Read()方法，返回值為bool判斷數(shù)據(jù)是否為空(也就是是否讀取到最后一行)，該方法將自動讀取下到下一條記錄。

作為一個初學(xué)者，本次只是簡單的介紹，并復(fù)習(xí)了一下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>
  /// 封裝一個執(zhí)行的sql 返回受影響的行數(shù)
  /// </summary>
  /// <param name="sqlText">執(zhí)行的sql腳本</param>
  /// <param name="parameters">參數(shù)集合</param>
  /// <returns>受影響的行數(shù)</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>
  /// 執(zhí)行sql，返回查詢結(jié)果中的第一行第一列的值
  /// </summary>
  /// <param name="sqlText">執(zhí)行的sql腳本</param>
  /// <param name="parameters">參數(shù)集合</param>
  /// <returns>查詢結(jié)果中的第一行第一列的值</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>
  /// 執(zhí)行sql 返回一個DataTable
  /// </summary>
  /// <param name="sqlText">執(zhí)行的sql腳本</param>
  /// <param name="parameters">參數(shù)集合</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>
  /// 執(zhí)行sql腳本
  /// </summary>
  /// <param name="sqlText">執(zhí)行的sql腳本</param>
  /// <param name="parameters">參數(shù)集合</param>
  /// <returns>返回一個SqlDataReader</returns>
  public static SqlDataReader ExecuteReader(string sqlText, params SqlParameter[] parameters)
  {
  //SqlDataReader要求，它讀取數(shù)據(jù)的時候有，它獨占它的SqlConnection對象，而且SqlConnection必須是Open狀態(tài)
  SqlConnection conn = new SqlConnection(GetSqlConnectionString());//不要釋放連接，因為后面還需要連接打開狀態(tài)
  SqlCommand cmd = conn.CreateCommand();
  conn.Open();
  cmd.CommandText = sqlText;
  cmd.Parameters.AddRange(parameters);
  //CommandBehavior.CloseConnection當(dāng)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
 {

 //封裝方法的原則，把不變的放在方法中，把變化的放在參數(shù)中傳進來

 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];
 // }
 // }
 //}

 //使用可變參數(shù)
 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];
  }
  }
 }
 }
}

您可能感興趣的文章: