SqlHelper初探之二

本文深入探讨了SQLHelper的实践应用,从其本质出发,详细解释了如何将D层代码中重复的操作提炼并封装成类,以提高代码复用性和灵活性。通过机房收费系统的案例,展示了SQLHelper在增删改查操作中的应用,并阐述了SQLHelper的分类和参数传递方式。

        在上一篇简单的介绍了sqlhelper的基本知识,接下来就让我们进一步学习他的实践过程。

       首先:我们要明白的一件事Sqlhelper不是写出来的,而是在D层的代码中提炼出来的?那么就会反问一句“D层中符合什么条件的代码才可以提炼出来呢?用Sqlhelper有什么用呢?”那么带着这些问题让我们进入思考:

         第一:Sqlhelper的代码不是写出来的,而是从D层的代码中提炼出来的,即把那些执行增删改查操作,存储过程及程序集等中相同的代码提炼出来,封装成一个类,便于复用的过程。

         第二:把它封装成一个类的好处就是:这提供了一种很好的使用 SqlHelper类来执行命令的模式,同时为开发人员选择访问数据的方式提供了必要的灵活性。每种方法的重载都支持不同的方法参数,因此开发人员可以确定传递连接、事务和参数信息的方式。

      其次:我们在该提炼的过程,要注意几点。Sqlhelper大概可分为两大类:一类是带参数,另一类是不带参数。当然带参数的就有返回值,不带参数的就没有返回值。好的明白这几点了就让我们通过机房收费系统来进一步实践吧!

    Imports System.Data  
    Imports System.Data.SqlClient  
    Imports System.Configuration  '必须要在管理器中添加引用    
    ''' <summary>  
    ''' SqlHelper类是专门提供给广大用户用于高性能、可升级和最佳练习的sql数据操作  
    ''' </summary>  
    ''' <remarks></remarks>  
    Public Class SqlHelper  
        '定义变量    
        '获得数据库的连接字符串    
        Private ReadOnly strConnection As String = ConfigurationManager.AppSettings("ConnStr")  
        '设置连接    
        Dim conn As SqlConnection = New SqlConnection(strConnection)  
        '定义cmd命令    
        Dim cmd As New SqlCommand  
      
        ''' <summary>    
        ''' 执行增删改三个操作,(有参)返回值为Boolean类型,确认是否执行成功    
        ''' </summary>    
        ''' <param name="cmdText">需要执行语句,一般是Sql语句,也有存储过程</param>    
        ''' <param name="cmdType">判断Sql语句的类型,一般都不是存储过程</param>    
        ''' <param name="paras">参数数组,无法确认有多少参数</param>    
        ''' <returns></returns>    
        ''' <remarks></remarks>    
        Public Function ExecAddDelUpdate(ByVal cmdText As String, ByVal cmdType As CommandType, ByVal paras As SqlParameter()) As Integer  
            '将传入的值,分别为cmd的属性赋值    
            cmd.Parameters.AddRange(paras)   '将参数传入    
            cmd.CommandType = cmdType            '设置一个值,解释cmdText    
            cmd.Connection = conn                '设置连接,全局变量    
            cmd.CommandText = cmdText            '设置查询的语句    
      
            Try  
                conn.Open()                      '打开连接    
                Return cmd.ExecuteNonQuery()     '执行增删改操作    
                cmd.Parameters.Clear()           '清除参数    
            Catch ex As Exception  
                Return 0                         '如果出错,返回0    
            Finally  
                Call CloseConn(conn)  
                Call CloseCmd(cmd)  
            End Try  
        End Function  
        ''' <summary>    
        ''' 执行增删改三个操作,(无参)    
        ''' </summary>    
        ''' <param name="cmdText">需要执行语句,一般是Sql语句,也有存储过程</param>    
        ''' <param name="cmdType">判断Sql语句的类型,一般都不是存储过程</param>    
        ''' <returns>Interger,受影响的行数</returns>    
        ''' <remarks>2013年2月2日8:19:59</remarks>    
        Public Function ExecAddDelUpdateNo(ByVal cmdText As String, ByVal cmdType As CommandType) As Integer  
            '为要执行的命令cmd赋值    
            cmd.CommandText = cmdText       '先是查询的sql语句    
            cmd.CommandType = cmdType       '设置Sql语句如何解释    
            cmd.Connection = conn           '设置连接    
      
            '执行操作    
            Try  
                conn.Open()  
                Return cmd.ExecuteNonQuery()  
            Catch ex As Exception  
                Return 0  
            Finally  
                Call CloseConn(conn)  
                Call CloseCmd(cmd)  
            End Try  
        End Function  
      
        ''' <summary>    
        ''' 执行查询的操作,(有参),参数不限    
        ''' </summary>    
        ''' <param name="cmdText">需要执行语句,一般是Sql语句,也有存储过程</param>    
        ''' <param name="cmdType">判断Sql语句的类型,一般都不是存储过程</param>    
        ''' <param name="paras">传入的参数</param>    
        ''' <returns></returns>    
        ''' <remarks></remarks>    
        Public Function ExecSelect(ByVal cmdText As String, ByVal cmdType As CommandType, ByVal paras As SqlParameter()) As DataTable  
      
            Dim sqlAdapter As SqlDataAdapter  
            Dim dt As New DataTable  
            Dim ds As New DataSet  
            '还是给cmd赋值    
            cmd.CommandText = cmdText  
            cmd.CommandType = cmdType  
            cmd.Connection = conn  
            cmd.Parameters.AddRange(paras)  '参数添加    
            sqlAdapter = New SqlDataAdapter(cmd)  '实例化adapter    
            Try  
                sqlAdapter.Fill(ds)           '用adapter将dataSet填充     
                dt = ds.Tables(0)             'datatable为dataSet的第一个表    
                cmd.Parameters.Clear()        '清除参数    
            Catch ex As Exception  
                MsgBox("查询失败", CType(vbOKOnly + MsgBoxStyle.Exclamation, MsgBoxStyle), "警告")  
            Finally                            '最后一定要销毁cmd    
                Call CloseCmd(cmd)  
            End Try  
            Return dt  
        End Function  
      
      
        ''' <summary>    
        ''' 执行查询的操作,(无参)    
        ''' </summary>    
        ''' <param name="cmdText">需要执行语句,一般是Sql语句,也有存储过程</param>    
        ''' <param name="cmdType">判断Sql语句的类型,一般都不是存储过程</param>    
        ''' <returns>dataTable,查询到的表格</returns>    
        ''' <remarks></remarks>    
        Public Function ExecSelectNo(ByVal cmdText As String, ByVal cmdType As CommandType) As DataTable  
            Dim sqlAdapter As SqlDataAdapter  
            Dim ds As New DataSet  
            '还是给cmd赋值    
            cmd.CommandText = cmdText  
            cmd.CommandType = cmdType  
            cmd.Connection = conn  
            sqlAdapter = New SqlDataAdapter(cmd)  '实例化adapter    
            Try  
                sqlAdapter.Fill(ds)           '用adapter将dataSet填充     
                Return ds.Tables(0)             'datatable为dataSet的第一个表    
            Catch ex As Exception  
                Return Nothing  
            Finally                            '最后一定要销毁cmd    
                Call CloseCmd(cmd)  
            End Try  
        End Function  
      
        ''' <summary>    
        ''' 关闭连接    
        ''' </summary>    
        ''' <param name="conn">需要关闭的连接</param>    
        ''' <remarks></remarks>    
        Public Sub CloseConn(ByVal conn As SqlConnection)  
            If (conn.State <> ConnectionState.Closed) Then  '如果没有关闭    
                conn.Close()                    '关闭连接    
                conn = Nothing                  '不指向原对象    
            End If  
      
        End Sub  
        ''' <summary>    
        ''' 关闭命令    
        ''' </summary>    
        ''' <param name="cmd">需要关闭的命令</param>    
        ''' <remarks></remarks>    
        Public Sub CloseCmd(ByVal cmd As SqlCommand)  
      
            If Not IsNothing(cmd) Then          '如果cmd命令存在    
                cmd.Dispose()                   '销毁    
                cmd = Nothing  
            End If  
        End Sub  
    End Class  
        总结:以上就是我对Sqlhelper的一些初步的理解和运用,希望在今后的学习中更进一步的学习和运用!

### SqlHelper 使用方法及介绍 SqlHelper 是一个用于简化数据库操作的工具类,它封装了常见的 SQL 操作,例如执行查询、插入、更新和删除等。以下是关于 SqlHelper 的详细介绍和使用方法: #### 1. SqlHelper 类概述 SqlHelper 是一个静态工具类,通常被设计为不可实例化(通过 `sealed` 或 `private` 构造函数实现)。它提供了多种静态方法来执行 SQL 命令[^1]。这些方法可以处理参数化查询,从而避免 SQL 注入问题。 #### 2. SqlHelper 的核心功能 SqlHelper 提供了以下主要功能: - **执行非查询操作**:如插入、更新或删除数据。 - **执行查询操作**:如获取单个值、数据集或对象列表。 - **缓存参数信息**:通过 `SqlHelperParameterCache` 类,可以缓存 SQL 参数以提高性能[^1]。 #### 3. SqlHelper 的典型方法 以下是 SqlHelper 中的一些常用方法及其功能说明: - **`ExecuteNonQuery` 方法** ```csharp public static int ExecuteNonQuery( string connectionString, CommandType commandType, string commandText, params SqlParameter[] commandParameters ) ``` 该方法用于执行不返回结果集的 SQL 命令,例如 `INSERT`、`UPDATE` 或 `DELETE` 操作。它返回受影响的行数[^1]。 - **`ExecuteScalar` 方法** ```csharp public static object ExecuteScalar( string connectionString, CommandType commandType, string commandText, params SqlParameter[] commandParameters ) ``` 该方法用于执行返回单个值的 SQL 查询,例如统计记录数的操作[^1]。 - **`ExecuteDataset` 方法** ```csharp public static DataSet ExecuteDataset( string connectionString, CommandType commandType, string commandText, params SqlParameter[] commandParameters ) ``` 该方法用于执行返回数据集的 SQL 查询,并将结果存储在 `DataSet` 对象中[^1]。 #### 4. 配置与初始化 在使用 SqlHelper 之前,需要正确配置数据库连接字符串。这通常在项目的配置文件中完成,例如 `app.config` 或 `web.config` 文件。此外,如果项目使用 ORM 框架,则需要确保框架的配置与 SqlHelper 兼容[^2]。 #### 5. 示例代码 以下是一个简单的 SqlHelper 使用示例: ```csharp using System; using System.Data; using System.Data.SqlClient; class Program { static void Main() { string connectionString = "your_connection_string_here"; string sqlQuery = "INSERT INTO Users (Name, Age) VALUES (@Name, @Age)"; SqlParameter[] parameters = new SqlParameter[] { new SqlParameter("@Name", SqlDbType.NVarChar, 50) { Value = "John Doe" }, new SqlParameter("@Age", SqlDbType.Int) { Value = 30 } }; int rowsAffected = SqlHelper.ExecuteNonQuery(connectionString, CommandType.Text, sqlQuery, parameters); if (rowsAffected > 0) { Console.WriteLine("Data inserted successfully."); } else { Console.WriteLine("Failed to insert data."); } } } ``` #### 6. 关于 `retBool` 方法 `retBool` 是 SqlHelper 中的一个辅助方法,用于判断 SQL 操作是否成功。它的底层逻辑是对影响的行数进行检查,如果返回值大于等于 1,则认为操作成功[^3]。 ```csharp public static bool retBool(int? result) { return result.HasValue && result.Value >= 1; } ``` ### 注意事项 - 确保在使用 SqlHelper 时传递正确的参数类型和值,以避免运行时错误。 - 如果项目中同时使用了 ORM 框架,请注意两者之间的冲突或冗余配置[^2]。
评论 16
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值