C#でSqlHelperクラスを書いて使い方を詳しく解説

この記事では主に C# を使用して SqlHelper クラスを作成する方法を紹介します。編集者はそれを参考として共有します。編集者をフォローして見てみましょう

勉強もコーディングもできず、退屈な週末です。何かやるべきことを見つけたいと思っていましたが、何をすればよいのかわかりませんでした。あるとき、学習した SqlHelper をほとんど忘れていることに気づきました。するとトラの体が震え、どうしてこんなに沈むことができるのかと思い、すぐにコンピュータの電源を入れ、両手でキーボードに触れました。この記事は、学習プロセス中の復習と知識の共有を目的として書きました（暇つぶしとして -^.^-）。

本文を始めましょう

ここでは、コンソール プログラムを例として取り上げます。まず、接続文字列を構成する必要があります:

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

パラメータの説明: 上記と同様。

このメソッドの戻り値はオブジェクトなので、クエリしているデータの種類がわからないときにこのクラスを使用できます。

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オブジェクトを使用する必要があるため、解放できません。このタイプのデータは 1 行ずつ読み取られます。読み取りでは、このクラスの 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); 
    }
  }
}

以上がC#でSqlHelperクラスを書いて使い方を詳しく解説の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。