using NX_LogClassLibrary; using NX_ModelClassLibrary.CustomEnum; using System; using System.Collections; using System.Collections.Generic; using System.Data; using System.Data.SqlClient; using System.Linq; using System.Text; using System.Threading.Tasks; namespace NX_DbClassLibrary { /// /// Copyright20181102 (C) sunyalong /// 数据访问抽象基础类(基于SQLServer) /// 允许修改、添加满足自己项目的需要。 /// 添加、修改后请详细注释。违者会强制删除不予采用。 /// public abstract class LeadDbHelperSQLServer { public static string connectionString = LeadConfigureConnectionString.GetConnectionString("LeadSqlServer"); #region 公用方法 /// /// 判断是否存在某表的某个字段 /// /// 表名称 /// 列名称 /// 是否存在 public static bool ColumnExists(string tableName, string columnName) { string sql = "select count(1) from syscolumns where [id]=object_id('" + tableName + "') and [name]='" + columnName + "'"; object res = GetSingle(sql); if (res == null) { return false; } return Convert.ToInt32(res) > 0; } /// /// 表是否存在 /// /// 数据表名称 /// public static bool TabExists(string TableName) { string strsql = "select count(*) from sysobjects where id = object_id(N'[" + TableName + "]') and OBJECTPROPERTY(id, N'IsUserTable') = 1"; object obj = GetSingle(strsql); int cmdresult; if ((Equals(obj, null)) || (Equals(obj, DBNull.Value))) { cmdresult = 0; } else { cmdresult = int.Parse(obj.ToString()); } if (cmdresult == 0) { return false; } else { return true; } } #endregion #region 执行简单SQL语句 /// /// 执行SQL语句,返回影响的记录数 /// /// SQL语句 /// 影响的记录数 public static int ExecuteSql(string SQLString) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand(SQLString, connection)) { try { connection.Open(); int rows = cmd.ExecuteNonQuery(); return rows; } catch (SqlException e) { connection.Close(); LogHelper.WriteLog($"执行SQL语句发生异常:【{e.Message}】!SQL:【{SQLString}】",LogTypeEnum.DbErr); return 0; } } } } /// /// 执行SQL语句,返回影响的记录数。(可配置超时时间) /// /// SQL语句 /// 超时时间设置(单位:秒)默认值30 /// public static int ExecuteSqlByTime(string SQLString, int Times) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand(SQLString, connection)) { try { connection.Open(); cmd.CommandTimeout = Times; int rows = cmd.ExecuteNonQuery(); return rows; } catch (SqlException e) { connection.Close(); LogHelper.WriteLog($"执行SQL语句发生异常:【{e.Message}】!SQL:【{SQLString}】超时时间:【{Times}】", LogTypeEnum.DbErr); return 0; } } } } /// /// 执行多条SQL语句,实现数据库事务。 /// /// 多条SQL语句List集合 public static int ExecuteSqlTran(List SQLStringList) { using (SqlConnection conn = new SqlConnection(connectionString)) { conn.Open(); using (SqlCommand cmd = new SqlCommand()) { cmd.Connection = conn; SqlTransaction tx = conn.BeginTransaction(); cmd.Transaction = tx; try { int count = 0; for (int n = 0; n < SQLStringList.Count; n++) { string strsql = SQLStringList[n]; if (strsql.Trim().Length > 1) { cmd.CommandText = strsql; count += cmd.ExecuteNonQuery(); } } tx.Commit(); return count; } catch (Exception ex) { tx.Rollback(); string errSql = string.Empty; for (int n = 0; n < SQLStringList.Count; n++) { errSql += $"【{SQLStringList[n]}】"; } LogHelper.WriteLog($"执行SQL语句发生异常:【{ex.Message}】!SQL语句:{errSql}", LogTypeEnum.DbErr); return 0; } } } } /// /// 执行带一个特殊参数的的SQL语句。 /// /// SQL语句 /// 参数内容,比如一个字段是格式复杂的文章,有特殊符号,可以通过这个方式添加参数 /// 影响的记录数 public static int ExecuteSql(string SQLString, string content) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand(SQLString, connection)) { SqlParameter myParameter = new SqlParameter("@content", SqlDbType.NText) { Value = content }; cmd.Parameters.Add(myParameter); try { connection.Open(); int rows = cmd.ExecuteNonQuery(); return rows; } catch (SqlException e) { LogHelper.WriteLog($"执行SQL语句发生异常:【{e.Message}】!SQL:【{SQLString}】特殊参数:【{content}】", LogTypeEnum.DbErr); return 0; } finally { cmd.Dispose(); connection.Close(); } } } } /// /// 向数据库里插入图像格式的字段(和上面情况类似的另一种实例) /// /// SQL语句 /// 图像字节,数据库的字段类型为image的情况 /// 影响的记录数 public static int ExecuteSqlInsertImg(string strSQL, byte[] fs) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand(strSQL, connection)) { SqlParameter myParameter = new SqlParameter("@fs", SqlDbType.Image) { Value = fs }; cmd.Parameters.Add(myParameter); try { connection.Open(); int rows = cmd.ExecuteNonQuery(); return rows; } catch (SqlException e) { string bytStr = string.Empty; foreach (byte item in fs) { bytStr += $"【{item}】"; } LogHelper.WriteLog($"向数据库里插入图像格式的字段发生异常:【{e.Message}】!SQL:【{strSQL}】图像字节:【{bytStr}】", LogTypeEnum.DbErr); return 0; } finally { cmd.Dispose(); connection.Close(); } } } } /// /// 执行一条计算查询结果语句,返回查询结果(object)。 /// /// 计算查询结果sql语句 /// 查询结果(object) public static object GetSingle(string SQLString) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand(SQLString, connection)) { try { connection.Open(); object obj = cmd.ExecuteScalar(); if ((Equals(obj, null)) || (Equals(obj, DBNull.Value))) { return null; } else { return obj; } } catch (SqlException e) { connection.Close(); LogHelper.WriteLog($"执行一条计算查询结果的语句发生异常:【{e.Message}】!SQL:【{SQLString}】", LogTypeEnum.DbErr); return null; } } } } /// /// 执行一条计算查询结果语句,返回查询结果(object)。 /// /// 计算查询结果sql语句 /// 超时时间设置(单位:秒)默认值30 /// public static object GetSingle(string SQLString, int Times) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand(SQLString, connection)) { try { connection.Open(); cmd.CommandTimeout = Times; object obj = cmd.ExecuteScalar(); if ((Equals(obj, null)) || (Equals(obj, DBNull.Value))) { return null; } else { return obj; } } catch (SqlException e) { connection.Close(); LogHelper.WriteLog($"执行一条计算查询结果的语句发生异常:【{e.Message}】!SQL:【{SQLString}】超时时间:【{Times}】", LogTypeEnum.DbErr); return null; } } } } /// /// 执行查询语句,返回SqlDataReader ( 注意:调用该方法后,一定要对SqlDataReader进行Close ) /// /// 查询语句 /// SqlDataReader public static SqlDataReader ExecuteReader(string strSQL) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand(strSQL, connection)) { try { connection.Open(); SqlDataReader myReader = cmd.ExecuteReader(CommandBehavior.CloseConnection); return myReader; } catch (SqlException e) { LogHelper.WriteLog($"执行查询语句,返回SqlDataReader发生异常:【{e.Message}】!SQL:【{strSQL}】", LogTypeEnum.DbErr); return null; } } } } /// /// 执行查询语句,返回DataSet /// /// 查询sql语句 /// DataSet public static DataSet Query(string SQLString) { using (SqlConnection connection = new SqlConnection(connectionString)) { DataSet ds = new DataSet(); try { connection.Open(); SqlDataAdapter command = new SqlDataAdapter(SQLString, connection); command.Fill(ds, "ds"); } catch (SqlException ex) { LogHelper.WriteLog($"执行查询语句,返回DataSet发生异常:【{ex.Message}】!SQL:【{SQLString}】", LogTypeEnum.DbErr); } return ds; } } /// /// 执行查询语句,返回DataSet /// /// 查询sql语句 /// 超时时间设置(单位:秒)默认值30 /// public static DataSet Query(string SQLString, int Times) { using (SqlConnection connection = new SqlConnection(connectionString)) { DataSet ds = new DataSet(); try { connection.Open(); SqlDataAdapter command = new SqlDataAdapter(SQLString, connection); command.SelectCommand.CommandTimeout = Times; command.Fill(ds, "ds"); } catch (SqlException ex) { LogHelper.WriteLog($"执行查询语句,返回DataSet发生异常:【{ex.Message}】!SQL:【{SQLString}】超时时间:【{Times}】", LogTypeEnum.DbErr); } return ds; } } #endregion #region 执行带参数的SQL语句 /// /// 执行SQL语句,返回影响的记录数 /// /// SQL语句 /// 参数集合 /// 影响的记录数 public static int ExecuteSql(string SQLString, params SqlParameter[] cmdParms) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand()) { string retParmStr = string.Empty; try { retParmStr = PrepareCommand(cmd, connection, null, SQLString, cmdParms); int rows = cmd.ExecuteNonQuery(); cmd.Parameters.Clear(); return rows; } catch (SqlException ex) { LogHelper.WriteLog($"执行SQL语句,返回影响的记录数发生异常:【{ex.Message}】!SQL:【{SQLString}】{retParmStr}", LogTypeEnum.DbErr); return 0; } } } } /// /// 执行多条SQL语句,实现数据库事务。 /// /// SQL语句的哈希表(key为sql语句,value是该语句的SqlParameter[]) /// 影响的记录数 public static int ExecuteSqlTran(Hashtable SQLStringList) { using (SqlConnection conn = new SqlConnection(connectionString)) { conn.Open(); using (SqlTransaction trans = conn.BeginTransaction()) { SqlCommand cmd = new SqlCommand(); try { int val = 0; //循环 foreach (DictionaryEntry myDE in SQLStringList) { string cmdText = myDE.Key.ToString(); SqlParameter[] cmdParms = (SqlParameter[])myDE.Value; PrepareCommand(cmd, conn, trans, cmdText, cmdParms); val += cmd.ExecuteNonQuery(); cmd.Parameters.Clear(); } trans.Commit(); return val; } catch(Exception ex) { trans.Rollback(); string retStr = string.Empty; foreach (DictionaryEntry myDE in SQLStringList) { string cmdText = myDE.Key.ToString(); SqlParameter[] cmdParms = (SqlParameter[])myDE.Value; if (cmdParms.Length > 0) { string paramStr = string.Empty; foreach (SqlParameter item in cmdParms) { paramStr += $"(参数名称:[{item.ParameterName}]参数值:[{item.Value}])"; } retStr += $"【sql:[{cmdText}] 参数集合:{paramStr}】"; } else { retStr += $"【sql:[{cmdText}]】"; } } LogHelper.WriteLog($"执行多条SQL语句,实现数据库事务发生异常:【{ex.Message}】!{retStr}", LogTypeEnum.DbErr); return 0; } } } } /// /// 执行一条计算查询结果语句,返回查询结果(object)。 /// /// 计算查询结果语句 /// 查询结果(object) public static object GetSingle(string SQLString, params SqlParameter[] cmdParms) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand()) { string retParmStr = string.Empty; try { retParmStr = PrepareCommand(cmd, connection, null, SQLString, cmdParms); object obj = cmd.ExecuteScalar(); cmd.Parameters.Clear(); if ((Equals(obj, null)) || (Equals(obj, DBNull.Value))) { return null; } else { return obj; } } catch (SqlException ex) { LogHelper.WriteLog($"执行一条计算查询结果语句,返回查询结果(object)发生异常:【{ex.Message}】!SQL:【{SQLString}】{retParmStr}", LogTypeEnum.DbErr); return 0; } } } } /// /// 执行查询语句,返回SqlDataReader ( 注意:调用该方法后,一定要对SqlDataReader进行Close ) /// /// 查询语句 /// SqlDataReader public static SqlDataReader ExecuteReader(string SQLString, params SqlParameter[] cmdParms) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand()) { string retParmStr = string.Empty; try { retParmStr = PrepareCommand(cmd, connection, null, SQLString, cmdParms); SqlDataReader myReader = cmd.ExecuteReader(CommandBehavior.CloseConnection); cmd.Parameters.Clear(); return myReader; } catch (SqlException ex) { LogHelper.WriteLog($"执行查询语句,返回SqlDataReader发生异常:【{ex.Message}】!SQL:【{SQLString}】{retParmStr}", LogTypeEnum.DbErr); return null; } finally { cmd.Dispose(); connection.Close(); } } } } /// /// 执行查询语句,返回DataSet /// /// 查询语句 /// 参数集合 /// public static DataSet Query(string SQLString, params SqlParameter[] cmdParms) { using (SqlConnection connection = new SqlConnection(connectionString)) { using (SqlCommand cmd = new SqlCommand()) { string paramStr = string.Empty; paramStr = PrepareCommand(cmd, connection, null, SQLString, cmdParms); using (SqlDataAdapter da = new SqlDataAdapter(cmd)) { DataSet ds = new DataSet(); try { da.Fill(ds, "ds"); cmd.Parameters.Clear(); } catch (SqlException ex) { LogHelper.WriteLog($"执行查询语句,返回DataSet发生异常:【{ex.Message}】!SQL:【{SQLString}】{paramStr}", LogTypeEnum.DbErr); } return ds; } } } } private static string PrepareCommand(SqlCommand cmd, SqlConnection conn, SqlTransaction trans, 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 = CommandType.Text;//cmdType; if (cmdParms != null) { string paramStr = string.Empty; foreach (SqlParameter parameter in cmdParms) { if ((parameter.Direction == ParameterDirection.InputOutput || parameter.Direction == ParameterDirection.Input) && (parameter.Value == null)) { parameter.Value = DBNull.Value; } cmd.Parameters.Add(parameter); paramStr += $"【参数名称:[{parameter.ParameterName}]参数值:[{parameter.Value}]】"; } return paramStr; } else { return null; } } #endregion #region 存储过程操作 /// /// 执行存储过程,返回SqlDataReader ( 注意:调用该方法后,一定要对SqlDataReader进行Close ) /// /// 存储过程名 /// 存储过程参数 /// SqlDataReader public static SqlDataReader RunProcedure(string storedProcName, IDataParameter[] parameters) { using (SqlConnection connection = new SqlConnection(connectionString)) { SqlDataReader returnReader; connection.Open(); using (SqlCommand command = BuildQueryCommand(connection, storedProcName, parameters)) { try { command.CommandType = CommandType.StoredProcedure; returnReader = command.ExecuteReader(CommandBehavior.CloseConnection); return returnReader; } catch (Exception ex) { string retParamStr = string.Empty; foreach (IDataParameter item in parameters) { retParamStr += $"【参数名称:[{item.ParameterName}]参数值:[{item.Value}]】"; } LogHelper.WriteLog($"执行存储过程,返回SqlDataReader发生异常:【{ex.Message}】!存储过程:【{storedProcName}】{retParamStr}", LogTypeEnum.DbErr); return null; } } } } /// /// 执行存储过程,返回存储过程结果集DataSet中的某个表。 /// /// 存储过程名 /// 存储过程参数 /// DataSet结果中的表名 /// DataSet public static DataSet RunProcedure(string storedProcName, IDataParameter[] parameters, string tableName) { using (SqlConnection connection = new SqlConnection(connectionString)) { DataSet dataSet = new DataSet(); connection.Open(); using (SqlDataAdapter sqlDA = new SqlDataAdapter()) { try { sqlDA.SelectCommand = BuildQueryCommand(connection, storedProcName, parameters); sqlDA.Fill(dataSet, tableName); connection.Close(); return dataSet; } catch (Exception ex) { string retParamStr = string.Empty; foreach (IDataParameter item in parameters) { retParamStr += $"【参数名称:[{item.ParameterName}]参数值:[{item.Value}]】"; } LogHelper.WriteLog($"执行存储过程,返回存储过程结果集DataSet中的某个表发生异常:【{ex.Message}】!存储过程:【{storedProcName}】{retParamStr} 表名称:【{tableName}】", LogTypeEnum.DbErr); return dataSet; } } } } /// /// 执行存储过程,返回存储过程结果集DataSet中的某个表。 /// /// 存储过程名 /// 存储过程参数 /// DataSet结果中的表名 /// 超时时间设置(单位:秒)默认值30 /// DataSet public static DataSet RunProcedure(string storedProcName, IDataParameter[] parameters, string tableName, int Times) { using (SqlConnection connection = new SqlConnection(connectionString)) { DataSet dataSet = new DataSet(); connection.Open(); using (SqlDataAdapter sqlDA = new SqlDataAdapter()) { try { sqlDA.SelectCommand = BuildQueryCommand(connection, storedProcName, parameters); sqlDA.SelectCommand.CommandTimeout = Times; sqlDA.Fill(dataSet, tableName); connection.Close(); return dataSet; } catch (Exception ex) { string retParamStr = string.Empty; foreach (IDataParameter item in parameters) { retParamStr += $"【参数名称:[{item.ParameterName}]参数值:[{item.Value}]】"; } LogHelper.WriteLog($"执行存储过程,返回存储过程结果集DataSet中的某个表发生异常:【{ex.Message}】!存储过程:【{storedProcName}】{retParamStr} 表名称:【{tableName}】超时时间:【{Times}】", LogTypeEnum.DbErr); return dataSet; } } } } /// /// 构建 SqlCommand 对象(用来返回一个结果集,而不是一个整数值) /// /// 数据库连接 /// 存储过程名 /// 存储过程参数 /// SqlCommand private static SqlCommand BuildQueryCommand(SqlConnection connection, string storedProcName, IDataParameter[] parameters) { SqlCommand command = new SqlCommand(storedProcName, connection) { CommandType = CommandType.StoredProcedure }; foreach (SqlParameter parameter in parameters) { if (parameter != null) { // 检查未分配值的输出参数,将其分配以DBNull.Value. if ((parameter.Direction == ParameterDirection.InputOutput || parameter.Direction == ParameterDirection.Input) && (parameter.Value == null)) { parameter.Value = DBNull.Value; } command.Parameters.Add(parameter); } } return command; } /// /// 执行存储过程,返回返回一个整数值 /// /// 存储过程名 /// 存储过程参数 /// 影响的行数 /// public static int RunProcedure(string storedProcName, IDataParameter[] parameters, out int rowsAffected) { using (SqlConnection connection = new SqlConnection(connectionString)) { int result; connection.Open(); using (SqlCommand command = BuildIntCommand(connection, storedProcName, parameters)) { try { rowsAffected = command.ExecuteNonQuery(); result = (int)command.Parameters["ReturnValue"].Value; return result; } catch (Exception ex) { string retParamStr = string.Empty; foreach (IDataParameter item in parameters) { retParamStr += $"【参数名称:[{item.ParameterName}]参数值:[{item.Value}]】"; } LogHelper.WriteLog($"执行存储过程,返回存储过程结果集DataSet中的某个表发生异常:【{ex.Message}】!存储过程:【{storedProcName}】{retParamStr} ", LogTypeEnum.DbErr); rowsAffected = 0; return 0; } } } } /// /// 创建 SqlCommand 对象实例(用来返回一个整数值) /// /// 存储过程名 /// 存储过程参数 /// SqlCommand 对象实例 private static SqlCommand BuildIntCommand(SqlConnection connection, string storedProcName, IDataParameter[] parameters) { SqlCommand command = BuildQueryCommand(connection, storedProcName, parameters); command.Parameters.Add(new SqlParameter("ReturnValue", SqlDbType.Int, 4, ParameterDirection.ReturnValue, false, 0, 0, string.Empty, DataRowVersion.Default, null)); return command; } #endregion #region 自定义方法 /// /// 数据库是否连接成功 /// /// public static bool ConnStatus() { using (SqlConnection connection = new SqlConnection(connectionString)) { try { connection.Open(); return true; } catch (SqlException ex) { connection.Close(); LogHelper.WriteLog($"测试数据库是否连接成功发生异常:【{ex.Message}】!", LogTypeEnum.DbErr); return false; } } } #endregion } }