using System;
using System.Data;
using System.Xml;
using System.Data.SqlClient;
using System.Collections;
using System.Configuration;
namespace ZGF.GYS.DAL
{
/// <summary>
/// The SqlHelper class is intended to encapsulate high performance, scalable best practices for
/// common uses of SqlClient
/// </summary>
public class DATASQLHelper
{
/// <summary>
/// 連接字符串
/// </summary>
public static string connstring = System.Configuration.ConfigurationManager.AppSettings["sqlconn"];
// 用戶緩存參數。
private static Hashtable parmCache = Hashtable.Synchronized(new Hashtable());
/// <summary>
/// 使用默認連接， 執行SQL語句，僅僅返回數據庫受影響行數。
/// 所需參數：命令文本，參數列表。
/// </summary>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns></returns>
public static int ExecuteNonQuery(string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
using (SqlConnection conn = new SqlConnection(connstring))
{
PrepareCommand(cmd, conn, null, CommandType.Text, cmdText, cmdParms);
int val = cmd.ExecuteNonQuery();
cmd.Parameters.Clear();
return val;
}
}
/// <summary>
/// 執行一個sql命令，僅僅返回數據庫受影響行數。
/// 所需參數：連接字符串，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="connString">連接字符串</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns>數據庫受影響行數</returns>
public static int ExecuteNonQuery(string connString, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
using (SqlConnection conn = new SqlConnection(connstring))
{
PrepareCommand(cmd, conn, null, cmdType, cmdText, cmdParms);
int val = cmd.ExecuteNonQuery();
cmd.Parameters.Clear();
return val;
}
}
/// <summary>
/// 執行一個sql命令，僅僅返回數據庫受影響行數。
/// 所需參數：連接對象，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="conn">連接對象</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns>數據庫受影響行數</returns>
public static int ExecuteNonQuery(SqlConnection conn, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
PrepareCommand(cmd,conn,null,cmdType,cmdText,cmdParms);
int val = cmd.ExecuteNonQuery();
cmd.Parameters.Clear();
return val;
}
/// <summary>
/// 執行一個sql命令，僅僅返回數據庫受影響行數。(用於需要事務的情況)
/// 所需參數：事務對象，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="trans">事務對象</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns>數據庫受影響行數</returns>
public static int ExecuteNonQuery(SqlTransaction trans, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
PrepareCommand(cmd, trans.Connection, trans, cmdType, cmdText, cmdParms);
int val = cmd.ExecuteNonQuery();
cmd.Parameters.Clear();
return val;
}
/// <summary>
/// 執行一個sql查詢語句，返回DataReader對象。使用默認連接。
/// 所需參數：命令文本，參數列表。
/// </summary>
/// <param name="cmdText"></param>
/// <param name="cmdParms"></param>
/// <returns></returns>
public static SqlDataReader ExecuteReader(string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
SqlConnection conn = new SqlConnection(connstring);
// 此處使用try/catch的原因：當出現異常時，也可以保證能關閉連接。
try
{
PrepareCommand(cmd, conn, null, CommandType.Text, cmdText, cmdParms);
SqlDataReader rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection);
cmd.Parameters.Clear();
return rdr;
}
catch
{
conn.Close();
throw;
}
}
/// <summary>
/// 執行一個sql查詢命令，返回DataReader對象。
/// 所需參數：連接字符串，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="connString">連接字符串</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns>查詢的結果 DataReader對象</returns>
public static SqlDataReader ExecuteReader(string connString, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
SqlConnection conn = new SqlConnection(connString);
// 此處使用try/catch的原因：當出現異常時，也可以保證能關閉連接。
try
{
PrepareCommand(cmd, conn, null, cmdType, cmdText, cmdParms);
SqlDataReader rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection);
cmd.Parameters.Clear();
return rdr;
}
catch
{
conn.Close();
throw;
}
}
/// <summary>
/// 執行一個sql查詢命令，返回DataReader對象。
/// 所需參數：連接對象，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="conn">連接對象</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns></returns>
public static SqlDataReader ExecuteReader(SqlConnection conn, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
PrepareCommand(cmd, conn, null, cmdType, cmdText, cmdParms);
SqlDataReader rdr = cmd.ExecuteReader();
cmd.Parameters.Clear();
return rdr;
}
/// <summary>
/// 執行一個sql查詢語句，返回查詢結果的第一行第一列的值。使用默認連接
/// 所需參數：命令文本，參數列表。
/// </summary>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns></returns>
public static object ExecuteScalar(string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
using (SqlConnection conn = new SqlConnection(connstring))
{
PrepareCommand(cmd, conn, null, CommandType.Text, cmdText, cmdParms);
object val = cmd.ExecuteScalar();
cmd.Parameters.Clear();
return val;
}
}
/// <summary>
/// 執行一個sql查詢命令，返回查詢結果的第一行第一列的值。
/// 所需參數：連接字符串，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="connString">連接字符串</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns>查詢結果的第一行第一列的值</returns>
public static object ExecuteScalar(string connString, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
using (SqlConnection conn = new SqlConnection(connstring))
{
PrepareCommand(cmd, conn, null, cmdType, cmdText, cmdParms);
object val = cmd.ExecuteScalar();
cmd.Parameters.Clear();
return val;
}
}
/// <summary>
/// 執行一個sql查詢命令，返回查詢結果的第一行第一列的值。
/// 所需參數：連接對象，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="conn">連接對象</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns>查詢結果的第一行第一列的值</returns>
public static object ExecuteScalar(SqlConnection conn, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
PrepareCommand(cmd, conn, null, cmdType, cmdText, cmdParms);
object val = cmd.ExecuteScalar();
cmd.Parameters.Clear();
return val;
}
/// <summary>
/// 執行一個sql查詢命令，返回查詢結果的第一行第一列的值, 支持事務。
/// 所需參數：事務對象，命令類型，命令文本，參數列表。
/// </summary>
/// <param name="tran">事務對象</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
/// <returns>查詢結果的第一行第一列的值</returns>
public static object ExecuteScalar(SqlTransaction tran, CommandType cmdType, string cmdText, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
PrepareCommand(cmd, tran.Connection, tran, cmdType, cmdText, cmdParms);
object val = cmd.ExecuteScalar();
cmd.Parameters.Clear();
return val;
}
/// <summary>
/// 執行一個SQL查詢，填充DataTable
/// </summary>
/// <param name="cmdText"></param>
/// <param name="dt"></param>
/// <param name="cmdParms"></param>
public static void FillDataTable(string cmdText, DataTable dt, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
using (SqlConnection conn = new SqlConnection(connstring))
{
PrepareCommand(cmd, conn, null, CommandType.Text, cmdText, cmdParms);
SqlDataAdapter ada = new SqlDataAdapter(cmd);
ada.Fill(dt);
ada.Dispose();
}
}
/// <summary>
/// 執行一個存儲過程，填充DataTable
/// </summary>
/// <param name="cmdText">存儲過程名稱</param>
/// <param name="dt">一個DataTable</param>
/// <param name="cmdParms">參數集合</param>
public static void FillDataTable2(string cmdText, DataTable dt, params SqlParameter[] cmdParms)
{
SqlCommand cmd = new SqlCommand();
using (SqlConnection conn = new SqlConnection(connstring))
{
PrepareCommand(cmd, conn, null, CommandType.StoredProcedure, cmdText, cmdParms);
SqlDataAdapter ada = new SqlDataAdapter(cmd);
ada.Fill(dt);
ada.Dispose();
}
}
/// <summary>
/// 緩存一個參數數組。
/// </summary>
/// <param name="cacheKey">參數數組在緩存中的名稱</param>
/// <param name="cmdParms">參數數組</param>
public static void SetCacheParameters(string cacheKey, params SqlParameter[] cmdParms)
{
parmCache[cacheKey] = cmdParms;
}
/// <summary>
/// 從緩存中獲取一個參數數組。
/// </summary>
/// <param name="cacheKey">參數數組在緩存中的名稱</param>
/// <returns>參數數組的副本</returns>
public static SqlParameter[] GetCachedParameters(string cacheKey)
{
SqlParameter[] cachedParms = (SqlParameter[])parmCache[cacheKey];
if (cachedParms == null)
return null;
//克隆一個參數數組的原因：此處的操作會對獲取的參數進行賦值操作。
SqlParameter[] clonedParms = new SqlParameter[cachedParms.Length];
for (int i = 0, j = cachedParms.Length; i < j; i++)
clonedParms[i] = (SqlParameter)((ICloneable)cachedParms[i]).Clone();
return clonedParms;
}
/// <summary>
/// 準備一個可以執行的Sql命令對象。
/// </summary>
/// <param name="cmd">命令對象</param>
/// <param name="conn">連接對象</param>
/// <param name="trans">事務對象</param>
/// <param name="cmdType">命令類型</param>
/// <param name="cmdText">命令文本</param>
/// <param name="cmdParms">參數列表</param>
private static void PrepareCommand(SqlCommand cmd, SqlConnection conn, SqlTransaction trans, CommandType cmdType, string cmdText, SqlParameter[] cmdParms)
{
if (conn.State != ConnectionState.Open)
conn.Open();
cmd.Connection = conn;
cmd.CommandText = cmdText;
if (trans != null)
cmd.Transaction = trans;
cmd.CommandType = cmdType;
if (cmdParms != null)
{
foreach (SqlParameter parm in cmdParms)
cmd.Parameters.Add(parm);
}
}
}
}