sqlhelper使用指南

转载 2007年09月25日 17:41:00

 sqlhelper使用指南

简介
您是否正在从事 .NET 应用程序数据访问代码的设计和开发?您是否觉得自己总是在反复编写相同的数据访问代码?您是否曾经将数据访问代码包装在 Helper 函数中,以便能够在一行中调用存储过程?如果是,那么 Microsoft%26amp;reg; Data Access Application Block for .NET 正是为您设计的。

Data Access Application Block 将访问 Microsoft SQL Server%26amp;#8482; 数据库的性能和资源管理方面的最佳经验封装在一起。您可以很方便地在自己的 .NET 应用程序中将其作为构造块使用,从页减少了需要创建、测试和维护的自定义代码的数量。

尤其是,Data Access Application Block 可以帮助您:

调用存储过程或 SQL 文本命令。
指定参数详细信息。
返回 SqlDataReader、DataSet 或 XMLReader 对象。
例如,在引用了 Data Access Application Block 的应用程序中,您可以简单地在一行代码中调用存储过程并生成 DataSet,如下所示:

[Visual Basic]
Dim ds As DataSet = SqlHelper.ExecuteDataset( _
connectionString, _
CommandType.StoredProcedure, _
"getProductsByCategory", _
new SqlParameter("@CategoryID", categoryID))

[C#]
DataSet ds = SqlHelper.ExecuteDataset(
connectionString,
CommandType.StoredProcedure,
"getProductsByCategory",
new SqlParameter("@CategoryID", categoryID));


注意: Application Block for .NET(用于 .NET 的应用程序块)是基于对成功的 .NET 应用程序进行详细研究而设计的。它以源代码的形式提供,您可以原样使用,也可以针对自己的应用程序进行自定义。该应用程序块并不代表未来 Microsoft ADO.NET 程序库的发展方向。Microsoft ADO.NET 程序库是为在各种使用情况下实现对数据访问行为的精确控制而建立的。将来的 ADO.NET 版本可能会使用不同的模型来实现这个方案

 

SqlHelper 类提供了一组静态方法,可以用来向 SQL Server 数据库发出许多各种不同类型的命令。

SqlHelperParameterCache 类提供命令参数缓存功能,可以用来提高性能。该类由许多 Execute 方法(尤其是那些只运行存储过程的重写方法)在内部使用。数据访问客户端也可以直接使用它来缓存特定命令的特定参数集。

使用 SqlHelper 类执行命令
SqlHelper 类提供了五种 Shared (Visual Basic) 或 static (C#) 方法,它们是:ExecuteNonQuery、ExecuteDataset、ExecuteReader、ExecuteScalar 和 ExecuteXMLReader。实现的每种方法都提供一组一致的重载。这提供了一种很好的使用 SqlHelper 类来执行命令的模式,同时为开发人员选择访问数据的方式提供了必要的灵活性。每种方法的重载都支持不同的方法参数,因此开发人员可以确定传递连接、事务和参数信息的方式。类中实现的所有方法都支持以下重载:

[Visual Basic]
Execute* (ByVal connection As SqlConnection, _
ByVal commandType As CommandType, _
ByVal CommandText As String)

Execute* (ByVal connection As SqlConnection, _
ByVal commandType As CommandType, _
ByVal commandText As String, _
ByVal ParamArray commandParameters() As SqlParameter)

Execute* (ByVal connection As SqlConnection, _
ByVal spName As String, _
ByVal ParamArray parameterValues() As Object)

Execute* (ByVal transaction As SqlTransaction, _
ByVal commandType As CommandType, _
ByVal commandText As String)

Execute* (ByVal transaction As SqlTransaction, _
ByVal commandType As CommandType, _
ByVal commandText As String, _
ByVal ParamArray commandParameters() As SqlParameter)

Execute* (ByVal transaction As SqlTransaction, _
ByVal spName As String, _
ByVal ParamArray parameterValues() As Object)

[C#]
Execute* (SqlConnection connection, CommandType commandType,
string commandText)

Execute* (SqlConnection connection, CommandType commandType,
string commandText, params SqlParameter[] commandParameters)

Execute* (SqlConnection connection, string spName,
params object[] parameterValues)

Execute* (SqlConnection connection,
CommandType commandType, string commandText)

Execute* (SqlConnection connection,
CommandType commandType, string commandText,
params SqlParameter[] commandParameters)

Execute* (SqlConnection connection,
string spName, params object[] parameterValues)

除这些重载以外,除 ExecuteXMLReader 之外的其他方法还提供了另一种重载:允许将连接信息作为连接字符串而不是连接对象来传递,如下面的方法签名所示:

[Visual Basic]
Execute* (ByVal connectionString As String, _
ByVal commandType As CommandType, _
ByVal commandText As String)

Execute* (ByVal connectionString As String, _
ByVal commandType As CommandType, _
ByVal commandText As String, _
ByVal ParamArray commandParameters() As SqlParameter)

Execute* (ByVal connectionString As String, _
ByVal spName As String, _
ByVal ParamArray parameterValues() As Object)

[C#]
Execute* (string connectionString, CommandType commandType,
string commandText)

Execute* (string connectionString, CommandType commandType,
string commandText,
params SqlParameter[] commandParameters)

Execute* (string connectionString, string spName,
params object[] parameterValues)

注意: ExecuteXMLReader 不支持连接字符串,因为:与 SqlDataReader 对象不同,XMLReader 对象在 XMLReader 关闭时没有提供自动关闭连接的方法。如果客户端传递了连接字符串,那么当客户端完成对 XMLReader 的操作后,将无法关闭与 XMLReader 相关联的连接对象。
通过参考 Data Access Application Block 程序集并导入 Microsoft.ApplicationBlocks.Data 命名空间,您可以轻松编写使用任何一种 SqlHelper 类方法的代码,如下面的代码示例所示:

[Visual Basic]
Imports Microsoft.ApplicationBlocks.Data

[C#]
using Microsoft.ApplicationBlocks.Data;

导入命名空间后,您可以调用任何 Execute* 方法,如下面的代码示例所示:

[Visual Basic]
Dim ds As DataSet = SqlHelper.ExecuteDataset( _
"SERVER=(local);DATABASE=Northwind;INTEGRATED SECURITY=True;",
_
CommandType.Text, "SELECT * FROM Products")

[C#]
DataSet ds = SqlHelper.ExecuteDataset(
"SERVER=DataServer;DATABASE=Northwind;INTEGRATED
SECURITY=sspi;", _
CommandType.Text, "SELECT * FROM Products");

使用 SqlHelperParameterCache 类管理参数
SqlHelperParameterCache 类提供了三种可以用来管理参数的公共共享方法。它们是:

CacheParameterSet。用于将 SqlParameters 数组存储到缓存中。
GetCachedParameterSet。用于检索缓存的参数数组的副本。
GetSpParameterSet。一种重载方法,用于检索指定存储过程的相应参数(首先查询一次数据库,然后缓存结果以便将来查询)。
缓存和检索参数
通过使用 CacheParameterSet 方法,可以缓存 SqlParameter 对象数组。此方法通过将连接字符串和命令文本连接起来创建一个键,然后将参数数组存储在 Hashtable 中。

要从缓存中检索参数,请使用 GetCachedParameterSet 方法。此方法将返回一个 SqlParameter 对象数组,这些对象已使用缓存(与传递给该方法的连接字符串和命令文本相对应)中的参数的名称、值、方向和数据类型等进行了初始化。

注意: 用作参数集的键的连接字符串通过简单的字符串比较进行匹配。用于从 GetCachedParameterSet 中检索参数的连接字符串必进入讨论组讨论。

【转】Sqlhelper 使用指南

摘要:Data Access Application Block 是一个 .NET 组件,包含优化的数据访问代码,可以帮助用户调用存储过程以及向 SQL Server 数据库发出 SQL 文本命令。它...
  • newnazi
  • newnazi
  • 2015年11月18日 11:46
  • 974

SqlHelper使用指南

摘要:Data Access Application Block 是一个 .NET 组件,包含优化的数据访问代码,可以帮助用户调用存储过程以及向 SQL Server 数据库发出 SQL 文本命令。它...
  • om001om
  • om001om
  • 2011年03月17日 15:43
  • 528

sqlhelper使用指南

摘要:Data Access Application Block 是一个 .NET 组件,包含优化的数据访问代码,可以帮助用户调用存储过程以及向 SQL Server 数据库发出 SQL 文本命令。它...
  • tearsmo
  • tearsmo
  • 2011年08月01日 15:58
  • 638

AutoConfig工具使用指南

13.1. 需求分析 13.1.1. 解决方案 13.2. AutoConfig的设计 13.2.1. 角色与职责13.2.2. 分享二进制目标文件13.2.3. 部署二进制目标文件13.2.4...

致Python初学者们 - Anaconda入门使用指南

打算学习 Python 来做数据分析的你,是不是在开始时就遇到各种麻烦呢? 到底该装 Python2 呢还是 Python3 ? 为什么安装 Python 时总是出错? 怎么安装工具包呢? 为什么提...

iOS 开发之FMDB的使用指南

iOS中原生的SQLite API在使用时,非常的不方便。于是,就出现了系列将SQLite API进行封装的库。例如:FMDB、PlausibleDatabase等。   FMDB的github地址:...

Glide最新版V4使用指南

本文章已授权微信公众号「码个蛋」 概述 集成基本用法注解V4新特性和自定义方法 1 在项目中实现AppGlideModule2 GlideEx...

iReport使用指南(有示例)

在使用ireport的过程中,因为各种功能都要百度,但是大家使用的例子又千差万别让人很苦恼,所以用一个简单例子贯穿的展示一下ireport的常见功能。 我使用的是iReport 3.5.1,使用的示...
  • GGdido
  • GGdido
  • 2016年04月15日 16:53
  • 2958

Android版抢票神器使用指南及下载地址

经过辛苦的一个星期,抢票神器Android版预览版终于可以和大家见面了.写个教程叫大家怎么使用神器. 神器的优势: 利用官方手机客户端通道刷票,连接更稳定,刷票成功率更高,目前市面上所有抢票软件都...

redis : 桌面管理工具 redis-desktop-manager使用指南

redis : 桌面管理工具 redis-desktop-manager使用指南 Posted on 2017-03-20 10:05 且行且思 阅读(3317) 评论(1) 编辑 收藏 ...
  • mmbbz
  • mmbbz
  • 2017年06月29日 20:58
  • 110
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章: sqlhelper使用指南
举报原因:
原因补充:

(最多只允许输入30个字)