快捷導(dǎo)航

詳解使用C#編寫SqlHelper類

更新時(shí)間：2017年09月18日 09:05:47 作者：A-Mortal

本篇文章主要介紹了使用C#編寫SqlHelper類，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

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

下面開(kāi)始正文

這里以控制臺(tái)程序?yàn)榘咐?。首先我們需要先配置一下連接字符串,我們需要在app.config文件中增加如下節(jié)點(diǎn):

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

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

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

2.下面來(lái)封裝第一個(gè)SqlHepler方法，封裝一個(gè)執(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();　　//打開(kāi)數(shù)據(jù)庫(kù)
       cmd.CommandText = sqlText;　　//對(duì)CommandText進(jìn)行賦值
       cmd.Parameters.AddRange(parameters);　　//對(duì)數(shù)據(jù)庫(kù)使用參數(shù)進(jìn)行賦值
       return cmd.ExecuteNonQuery();
     }
   }
}

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

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

3.繼續(xù)封裝一個(gè)查詢操作，返回查詢結(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ù)說(shuō)明:如上。

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

4.在封裝個(gè)常用的查詢方法，返回一個(gè)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ù)說(shuō)明:如上。

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

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

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

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

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

作為一個(gè)初學(xué)者，本次只是簡(jiǎn)單的介紹，并復(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>
    /// 封裝一個(gè)執(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 返回一個(gè)DataTable
    /// </summary>
    /// <param name="sqlText">執(zhí)行的sql腳本</param>
    /// <param name="parameters">參數(shù)集合</param>
    /// <returns>返回一個(gè)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>返回一個(gè)SqlDataReader</returns>
    public static SqlDataReader ExecuteReader(string sqlText, params SqlParameter[] parameters)
    {
      //SqlDataReader要求，它讀取數(shù)據(jù)的時(shí)候有，它獨(dú)占它的SqlConnection對(duì)象，而且SqlConnection必須是Open狀態(tài)
      SqlConnection conn = new SqlConnection(GetSqlConnectionString());//不要釋放連接，因?yàn)楹竺孢€需要連接打開(kāi)狀態(tài)
      SqlCommand cmd = conn.CreateCommand();
      conn.Open();
      cmd.CommandText = sqlText;
      cmd.Parameters.AddRange(parameters);
      //CommandBehavior.CloseConnection當(dāng)SqlDataReader釋放的時(shí)候，順便把SqlConnection對(duì)象也釋放掉
      return cmd.ExecuteReader(CommandBehavior.CloseConnection); 
    }
  }
}

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: