迟来SQLHelper

    机房收费系统我的重构版敲完登录系统以后日后敲了几个窗口,对于那些数据库链接SqlConnenction、SqlConnamd等经常敲反复的代码，以前也看过其它人的博客，这个东西不用还真不行。

 

    SqlHelper是什么？

    SqlHelper是一个基于·NETFramework的数据库操做组件。组件中包括数据库操做方法。

    SqlHelper的做用？

    SqlHelper用于简化你反复的去写那些数据库链接（SqlConnection）,SqlCommand,SqlDataReader等等。SqlHelper封装事后通常是仅仅需要给方法传入一些參数如数据库链接字符串，SQL參数等。就可以訪问数据库了。

机房我的重构Sqlhelper代码：

’****************************************************
’文件名称：SqlHelper
’命名空间：DAL
'内容：使用SqlHelper，提供较高的数据訪问性
’功能：
’文件关系：
’做者：赵亚盟
’小组：XXX
’生成日期：2014-07-17 14:44:38
’版本号号：V1.0.0.0
’改动日志：
’版本号说明：
'****************************************************
Imports System.Data
Imports System.Data.SqlClient  'SQLServer的链接对象
Imports System.Configuration  '配置文件的引用 （管理器中也要引用）
'------------------------------------------------------------------------------------------------------------------------------------------------------------------
Public Class SqlHelper

    Dim Connstr As String = ConfigurationManager.AppSettings("Connstr") '配置文件
    Dim conn As New SqlConnection  '定义链接
    Dim cmd As New SqlCommand      '定义命令
    Public Sub New()
        conn = New SqlConnection(Connstr)
    End Sub
#Region "有參数的查询操做"

    ''' <summary>
    '''运行查询操做。有參数返回datatable类型
    ''' </summary>
    ''' <param name="cmdText">需要运行语句。可以是Sql语句也可以是存储过程</param>
    ''' <param name="cmdType">推断Sql语句的类型，通常都不是存储过程</param>
    ''' <param name="paras">參数数组</param>
    ''' <returns>返回表</returns>
    ''' <remarks></remarks>
    Public Function GetDataTable(cmdText As String, cmdType As String, paras As SqlParameter()) As DataTable

        Dim adapter As New SqlDataAdapter
        Dim ds As New DataSet              '定义一个适配器对象
        Dim dt As New DataTable

        cmd.CommandText = cmdText          '设置查询语句
        cmd.CommandType = cmdType
        cmd.Connection = conn              '设置链接，全局变量
        cmd.Parameters.AddRange(paras)     '传入參数
        adapter = New SqlDataAdapter(cmd)  '实例化Adapter

        Try
            adapter.Fill(ds)               '用Adapter将Dataset填充
            dt = ds.Tables(0)              'datatable为DataSet的第一个表
            cmd.Parameters.Clear()         '清除參数
        Catch ex As Exception
            MsgBox("查询失败", CType(vbOKOnly + MsgBoxStyle.Exclamation, MsgBoxStyle), "警告")
        Finally
            Call CloseConn(conn)
            Call CloseCmd(cmd)             '销毁cmd
        End Try
        Return dt                          '返回受影响的行数

    End Function

#End Region

    '------------------------------------------------------------------------------------------------------------------------------------------------------------------------
#Region "无參数的查询操做"
    ''' <summary>
    '''运行查询操做。无參数返回datatable类型
    ''' </summary>
    ''' <param name="cmdText">需要运行语句，可以是Sql语句也可以是存储过程</param>
    ''' <param name="cmdType">推断Sql语句的类型，通常都不是存储过程</param>
    ''' <returns>返回表</returns>
    ''' <remarks></remarks>
    Public Function GetDataTable(ByVal cmdText As String, ByVal cmdType As CommandType) As DataTable

        Dim adapter As New SqlDataAdapter
        Dim ds As New DataSet             '定义一个适配器对象
        Dim dt As New DataTable

        cmd.CommandText = cmdText         '将sql语句传给cmdsql
        cmd.CommandType = cmdType         '肯定语句类型
        cmd.Connection = conn             '设置链接，全局变量
        adapter = New SqlDataAdapter(cmd) '实例化Adapter

        Try
            adapter.Fill(ds)              '用Adapter将Dataset填充
            dt = ds.Tables(0)             'datatable为DataSet的第一个表
        Catch ex As Exception
            MsgBox("查询失败", CType(vbOKOnly + MsgBoxStyle.Exclamation, MsgBoxStyle), "警告")
        Finally
            '销毁cmd
            Call CloseConn(conn)
            Call CloseCmd(cmd)
        End Try
        Return dt                         '返回受影响的行数

    End Function

#End Region
    '----------------------------------------------------------------------------------------------------------------------------------------------------------------------
#Region "有參数的增删改"
    ''' <summary>
    ''' ///运行有參数的增删改操做，有參数则返回Boolean类型，确认是否运行成功
    ''' </summary>
    ''' <param name="cmdText">需要运行语句。可以是Sql语句也可以是存储过程</param>
    ''' <param name="cmdType">推断Sql语句的类型。通常都不是存储过程</param>
    ''' <param name="paras">參数数组</param>
    ''' <returns>返回Boolean类型。成功返回true,不然返回false</returns>
    ''' <remarks></remarks>
    Public Function ExecuteNoQuery(cmdText As String, cmdType As CommandType, paras As SqlParameter()) As Boolean

        cmd.Parameters.AddRange(paras)   '传入參数
        cmd.CommandType = cmdType        '肯定语句类型
        cmd.CommandText = cmdText        '设置查询语句
        cmd.Connection = conn            '设置链接。全局变量

        Try
            conn.Open() '打开链接
            Return cmd.ExecuteNonQuery() '运行增删改操做
            cmd.Parameters.Clear()       '清除參数
        Catch ex As Exception
            Return False                 '假设出现错误，则返回false
        Finally
            '关闭数据库
            Call CloseConn(conn)
            Call CloseCmd(cmd)
        End Try

    End Function

#End Region
    '------------------------------------------------------------------------------------------------------------------------------------------------------------------------
#Region "无參数的增删改"
    ''' <summary>
    ''' ///运行增删改操做，无參返回Boolean型。确认是否运行成功
    ''' </summary>
    ''' <param name="cmdText">需要运行语句。可以是Sql语句也可以是存储过程</param>
    ''' <param name="cmdType">推断Sql语句的类型，通常都不是存储过程</param>
    ''' <returns>返回Boolean类型，成功返回true,不然返回false</returns>
    ''' <remarks></remarks>
    Public Function ExecuteNoQuery(cmdText As String, cmdType As CommandType) As Boolean

        cmd.CommandType = cmdType             '推断类型
        cmd.CommandText = cmdText             '设置查询语句
        cmd.Connection = conn                 '设置链接

        Try
            conn.Open()                       '打开链接
            Return cmd.ExecuteNonQuery()      '运行增删改操做
        Catch ex As Exception
            Return False                      '假设出现错误，则返回false
        Finally
            '关闭数据库
            Call CloseConn(conn)
            Call CloseCmd(cmd)
        End Try

    End Function

#End Region

    Public Sub CloseCmd(ByVal cmd As SqlCommand)
        '推断cmd命令是否存在。假设cmd命令不存在就销毁
        If Not IsNothing(cmd) Then
            cmd.Dispose()
            cmd = Nothing
        End If
    End Sub

    Public Sub CloseConn(ByVal conn As SqlConnection)
        '推断数据库链接对象状态是不是断开状态，，假设不是就断开
        If conn.State <> ConnectionState.Closed Then
            conn.Close()                               '关闭链接
        End If
    End Sub
End Class

在 SqlHelper 类中实现的方法包含：

      ExecuteNonQuery。用于运行(有參数或无參数的)不返回不论什么行或值的命令。这些命令通常常使用于运行数据库(增\删\改)更新，但也可用于返回存储过程的输出參数。

     ExecuteReader。此方法用于返回 SqlDataReader 对象，该对象包括由某一命令返回的结果集。

     ExecuteDataset。此方法返回DataSet 对象，该对象包括由某一命令返回的结果集。

 注意：在使用SqlHelper方法调用数据库存储过程时。需要获取存储过程的返回值。使用带有SSqlParameter[]參数的方法，Object[]參数的方法没法获取存储过程的返回值。