using System; using System.Collections.Generic; using System.Configuration; using System.Data; using System.Data.SqlClient; using System.Linq; using System.Text; using System.Threading.Tasks; namespace NFine.Data.Extensions { /// /// 数据库访问辅助类,add by ngye, on 2013-08-14. /// public static class SqlHelper { #region [ 连接串相关 ] /// /// 数据中心DB的连接字符串 /// public static string DataCenterConnString = ConfigurationManager.ConnectionStrings["connstr"].ConnectionString; /// /// 获取同步服务器的连接 /// /// public static SqlConnection GetDataCenterConn() { return new SqlConnection(DataCenterConnString); } /// /// 根据连接串获取连接 /// /// public static SqlConnection GetConnByString(string conn) { return new SqlConnection(conn); } /// /// 测试连接串是否能正确 /// /// 连接串 /// public static bool TestConnectionString(string connectionString) { bool result = true; try { using (SqlConnection conn = GetConnByString(connectionString)) { try { conn.Open(); } catch (Exception ex) { result = false; } } } catch (Exception) { result = false; } return result; } /// /// 测试连接串是否正确 /// /// 连接串 /// 测试的超时秒数 /// 错误时输出的错误信息 /// 是否能正常连接 public static bool TestConnectionString(string connectionString, int timeOut, ref string errInfo) { bool result = true; string[] arr = connectionString.Split(new char[] { ';' }); List list = new List(); foreach (string s in arr) { if (s.ToLower().IndexOf("timeout") == -1) { list.Add(s); } else { list.Add(String.Format("Connection Timeout={0}", timeOut)); } } SqlConnection con = null; try { con = new SqlConnection(string.Join(";", list.ToArray())); con.Open(); } catch (Exception ex) { result = false; errInfo = ex.Message; } finally { if (con != null) { con.Close(); con.Dispose(); con = null; } } return result; } #endregion #region [ 超时设置 ] public static int CommandTimeout { get { return 7200; } } #endregion #region [ ExecuteNonQuery ] /// /// 根据sql语句和参数,返回受影响行数 /// /// sql语句 /// 可变参数 /// 受影响行数 public static int ExecuteNonQuery(string sql, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); return cmd.ExecuteNonQuery(); } } public static int ExecuteNonQuery(string connStr, string sql, params SqlParameter[] spArr) { using (SqlConnection conn = new SqlConnection(connStr)) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); return cmd.ExecuteNonQuery(); } } #endregion #region [ ExecuteScalar_ForProc ] /// /// 根据存储过程和参数,返回Scalar结果 /// /// 存储过程 /// 可变参数 /// object public static object ExecuteScalar_ForProc(string proc, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(proc, conn).AddTimeout(); cmd.CommandType = CommandType.StoredProcedure; if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); object obj = cmd.ExecuteScalar(); return obj; } } /// /// 根据存储过程和参数,返回Scalar结果,但不加上超时设置 ( 避免循环做 AddTimeout ) /// /// 存储过程 /// 可变参数 /// object public static object ExecuteScalar_ForProc_WithoutAddTimeout(string proc, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(proc, conn); cmd.CommandType = CommandType.StoredProcedure; if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); object obj = cmd.ExecuteScalar(); return obj; } } #endregion #region [ ExecuteScalar ] /// /// 根据sql语句和参数,返回Scalar结果 /// /// sql语句 /// 可变参数 /// object public static object ExecuteScalar(string sql, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); object obj = cmd.ExecuteScalar(); return obj; } } #endregion #region [ QueryByProc ] /// /// 根据存储过程及参数,返回DataSet /// /// DataSet public static DataSet GetDataSetByProc(string proc, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(proc, conn).AddTimeout(); cmd.CommandType = CommandType.StoredProcedure; if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); SqlDataAdapter adapter = new SqlDataAdapter(cmd); DataSet ds = new DataSet(); adapter.Fill(ds); return ds; } } /// /// 根据存储过程及参数,返回DataTable /// /// DataTable public static DataTable GetDataTableByProc(string proc, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(proc, conn).AddTimeout(); cmd.CommandType = CommandType.StoredProcedure; if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); DataTable dt = cmd.ExecuteDataTable(); return dt; } } /// /// 根据sql语句和参数,返回DataRow /// /// sql语句 /// 可变参数 /// DataRow public static DataRow GetDataRowByProc(string proc, params SqlParameter[] spArr) { DataTable dt = GetDataTableByProc(proc, spArr); if (dt == null || dt.Rows.Count == 0) return null; return dt.Rows[0]; } #endregion #region [ Query ] /// /// 根据sql语句和参数,返回DataSet /// /// sql语句 /// 可变参数 /// DataSet public static DataSet GetDataSetBySql(string sql, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); SqlDataAdapter adapter = new SqlDataAdapter(cmd); DataSet ds = new DataSet(); adapter.Fill(ds); return ds; } } /// /// 根据sql语句和参数,返回DataTable /// /// sql语句 /// 可变参数 /// DataTable public static DataTable GetDataTableBySql(string sql, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetDataCenterConn()) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); DataTable dt = cmd.ExecuteDataTable(); return dt; } } /// /// 根据sql语句和参数,返回DataRow /// /// sql语句 /// 可变参数 /// DataRow public static DataRow GetDataRowBySql(string sql, params SqlParameter[] spArr) { DataTable dt = GetDataTableBySql(sql, spArr); if (dt == null || dt.Rows.Count == 0) return null; return dt.Rows[0]; } #endregion #region [ GetValue ] public static object GetValue(DataRow dr, string fieldName, object replaceValue) { if (dr.IsNull(fieldName)) return replaceValue; return dr[fieldName]; } public static object GetValue(DataRow dr, int idx, object replaceValue) { if (dr.IsNull(idx)) return replaceValue; return dr[idx]; } #endregion #region [ GetString ] public static string GetString(DataRow dr, string fieldName, string replaceValue) { if (dr.IsNull(fieldName)) return replaceValue; return Convert.ToString(dr[fieldName]); } public static string GetString(DataRow dr, int idx, string replaceValue) { if (dr.IsNull(idx)) return replaceValue; return Convert.ToString(dr[idx]); } #endregion #region [ GetDateTime ] public static DateTime GetDateTime(DataRow dr, string fieldName, DateTime replaceValue) { if (dr.IsNull(fieldName)) return replaceValue; return Convert.ToDateTime(dr[fieldName]); } public static DateTime GetDateTime(DataRow dr, int idx, DateTime replaceValue) { if (dr.IsNull(idx)) return replaceValue; return Convert.ToDateTime(dr[idx]); } #endregion #region [ 非数据中心库操作 ] #region [ ExecuteScalar ] /// /// 根据sql语句和参数,返回Scalar结果 /// /// 连接串 /// sql语句 /// 可变参数 /// object public static object ExecuteScalarWithConn(string connString, string sql, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetConnByString(connString)) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); object obj = cmd.ExecuteScalar(); return obj; } } #endregion #region [ ExecuteNonQuery ] /// /// 根据sql语句和参数,返回受影响行数 /// /// 连接串 /// sql语句 /// 可变参数 /// 受影响行数 public static int ExecuteNonQueryWithConn(string connString, string sql, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetConnByString(connString)) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); return cmd.ExecuteNonQuery(); } } #endregion #region [ Query ] /// /// 根据sql语句和参数,返回DataTable /// /// 连接串 /// sql语句 /// 可变参数 /// DataTable public static DataTable GetDataTableBySqlWithConn(string connString, string sql, params SqlParameter[] spArr) { using (SqlConnection conn = SqlHelper.GetConnByString(connString)) { conn.Open(); SqlCommand cmd = new SqlCommand(sql, conn).AddTimeout(); if (spArr.Length > 0) cmd.Parameters.AddRange(spArr.SetDBNull()); DataTable dt = cmd.ExecuteDataTable(); return dt; } } /// /// 根据sql语句和参数,返回DataRow /// /// 连接串 /// sql语句 /// 可变参数 /// DataRow public static DataRow GetDataRowBySqlWithConn(string connString, string sql, params SqlParameter[] spArr) { DataTable dt = GetDataTableBySqlWithConn(connString, sql, spArr); if (dt == null || dt.Rows.Count == 0) return null; return dt.Rows[0]; } #endregion #endregion #region [ 根据SQL文件路径执行 ] /// /// 执行SQL文件 /// /// /// /// public static bool ExecuteNonQueryWithConnAndSqlFilePath(string connString, string filePath) { string sql = System.IO.File.ReadAllText(filePath); return ExecuteNonQueryWithConnAndGO(connString, sql); } #endregion #region [ 执行带Go语句 ] /// /// 执行带"GO"的SQL,返回最后一条SQL的受影响行数 /// /// 连接串 /// sql语句 /// 返回最后一条SQL的受影响行数 public static bool ExecuteNonQueryWithConnAndGO(string connString, string sql) { bool result = true; string[] arr = System.Text.RegularExpressions.Regex.Split(sql, @"\bGO\b", System.Text.RegularExpressions.RegexOptions.IgnoreCase); using (SqlConnection conn = GetConnByString(connString)) { conn.Open(); SqlCommand cmd = new SqlCommand().AddTimeout(); cmd.Connection = conn; SqlTransaction tx = conn.BeginTransaction(); cmd.Transaction = tx; try { for (int n = 0; n < arr.Length; n++) { string strsql = arr[n]; if (strsql.Trim().Length > 1 && strsql.Trim().Replace(";", "") != "") { cmd.CommandText = strsql; cmd.ExecuteNonQuery(); } } tx.Commit(); } catch (System.Data.SqlClient.SqlException E) { tx.Rollback(); result = false; //return -1; throw new Exception(E.Message); } finally { if (conn.State != ConnectionState.Closed) { conn.Close(); conn.Dispose(); } } } return result; } #endregion /// /// 设置Sql参数 /// /// /// /// /// public static SqlParameter SetSqlParameter(string parameterName, object value, SqlDbType dbType) { if (value == null || string.IsNullOrEmpty(value.ToString())) { return new SqlParameter(parameterName, DBNull.Value); } SqlParameter sp = new SqlParameter(parameterName, value); sp.SqlDbType = dbType; return sp; } /// /// 根据sql及带 in 的id参数列表, 得到DataTable /// /// 带in ( {0} )的sql /// 以逗号分隔的id字符串 /// id的Sql数据类型 /// DataTable public static DataTable GetDataTableWithIn(string sql, string ids, SqlDbType idDbType) { SqlParameter[] spArr = GetWithInSqlParameters(ref sql, ids, idDbType); return GetDataTableBySql(sql, spArr); } /// /// 根据sql及带 in 的id参数列表, 得到受影响行数 /// /// 带in ( {0} )的sql /// 以逗号分隔的id字符串 /// id的Sql数据类型 /// DataTable public static int ExecuteNonQueryWithIn(string sql, string ids, SqlDbType idDbType) { SqlParameter[] spArr = GetWithInSqlParameters(ref sql, ids, idDbType); return ExecuteNonQuery(sql, spArr); } #region [ 带 in 不确定参数的执行方法 ] /// /// 获取带 in 的sql参数列表 /// /// 带in ( {0} )的sql /// 以逗号分隔的id字符串 /// id的Sql数据类型 /// sql参数列表 public static SqlParameter[] GetWithInSqlParameters(ref string sql, string ids, SqlDbType idDbType) { if (string.IsNullOrEmpty(ids)) { return null; } string[] idArr = ids.Split(','); //组建sql在in中的字符串 StringBuilder sbCondition = new StringBuilder(); List spList = new List(); for (int i = 0; i < idArr.Length; i++) { string id = idArr[i]; string spName = string.Format("@id{0}", i); sbCondition.AppendFormat("{0},", spName); spList.Add(SetSqlParameter(spName, id, idDbType)); } //重新构建sql sql = string.Format(sql, sbCondition.ToString().TrimEnd(',')); return spList.ToArray(); } #endregion }//end of class #region [ SqlHelper 的扩展方法类 ] /// /// 扩展方法类 /// public static class SqlHelperExtensionMethods { /// /// 新建SqlCommand对象时, 自动加上指定的 CommandTimeout. by ngye, on 2013-07-11. /// /// SqlCommand对象 /// SqlCommand对象 public static SqlCommand AddTimeout(this SqlCommand cmd) { cmd.CommandTimeout = SqlHelper.CommandTimeout; return cmd; } /// /// 新建SqlBulkCopy对象时, 自动加上指定的 BulkCopyTimeout. by ngye, on 2013-08-30. /// /// SqlBulkCopy对象 /// SqlBulkCopy对象 public static SqlBulkCopy AddTimeout(this SqlBulkCopy bulkCopy) { bulkCopy.BulkCopyTimeout = SqlHelper.CommandTimeout; return bulkCopy; } /// /// 执行cmd得到 DataTable. by ngye, on 2013-08-01 /// /// /// public static DataTable ExecuteDataTable(this SqlCommand cmd) { DataTable dt = new DataTable(); using (SqlDataAdapter adapter = new SqlDataAdapter(cmd)) { adapter.Fill(dt); } return dt; } /// /// 为SqlParameter设置参数. by ngye, on 2013-08-15. /// /// /// public static SqlParameter SetValue(this SqlParameter sp, object value) { sp.Value = value; return sp; } /// /// 为SqlParameter设置SqlDbType. by ngye, on 2013-09-03. /// /// /// public static SqlParameter SetSqlDbType(this SqlParameter sp, SqlDbType dbType) { sp.SqlDbType = dbType; return sp; } /// /// 对可以为空的值作这样的处理,一旦其为空,就设置为DBNull.value. /// /// /// public static SqlParameter[] SetDBNull(this SqlParameter[] spArr) { if (spArr == null || spArr.Length == 0) return spArr; for (int i = 0; i < spArr.Length; i++) { SqlParameter sp = spArr[i]; if (sp.Value == null) sp.Value = DBNull.Value; } return spArr; } } #endregion }