sqlhelper使用指南 之 使用 SqlHelper 类执行命令

摘要：Data Access Application Block 是一个 .NET 组件，包含优化的数据访问代码，可以帮助用户调用存储过程以及向 SQL Server 数据库发出 SQL 文本命令。它返回 SqlDataReader、DataSet 和 XmlReader 对象。您可以在自己的 .NET 应用程序中将其作为构造块来使用，以减少需要创建、测试和维护的自定义代码的数量。您可以下载完整的 C# 和 Visual Basic .NET 源代码以及综合文档。

简介

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

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

尤其是，Data Access Application Block 可以帮助您：

• 调用存储过程或 SQL 文本命令。
• 指定参数详细信息。
• 返回 SqlDataReader、DataSet 或 XmlReader 对象。

例如，在引用了 Data Access Application Block 的应用程序中，您可以简单地在一行代码中调用存储过程并生成 DataSet，如下所示：

 1 [Visual Basic]
 2 Dim ds As DataSet  =  SqlHelper.ExecuteDataset( _
 3       connectionString, _
 4       CommandType.StoredProcedure, _
 5        " getProductsByCategory " , _
 6        new  SqlParameter( " @CategoryID " , categoryID))
 7  
 8 [C#]
 9 DataSet ds  =  SqlHelper.ExecuteDataset( 
10       connectionString,
11       CommandType.StoredProcedure,
12        " getProductsByCategory " ,
13        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 类来执行命令的模式，同时为开发人员选择访问数据的方式提供了必要的灵活性。每种方法的重载都支持不同的方法参数，因此开发人员可以确定传递连接、事务和参数信息的方式。类中实现的所有方法都支持以下重载：

 1 [Visual Basic]
 2 Execute *  (ByVal connection As SqlConnection, _
 3           ByVal commandType As CommandType, _
 4           ByVal CommandText As String)
 5
 6 Execute *  (ByVal connection As SqlConnection, _
 7           ByVal commandType As CommandType, _
 8           ByVal commandText As String, _
 9           ByVal ParamArray commandParameters() As SqlParameter)
10
11 Execute *  (ByVal connection As SqlConnection, _
12           ByVal spName As String, _
13           ByVal ParamArray parameterValues() As Object)
14
15 Execute *  (ByVal transaction As SqlTransaction, _
16           ByVal commandType As CommandType, _
17           ByVal commandText As String)
18
19 Execute *  (ByVal transaction As SqlTransaction, _
20           ByVal commandType As CommandType, _
21           ByVal commandText As String, _
22           ByVal ParamArray commandParameters() As SqlParameter)
23
24 Execute *  (ByVal transaction As SqlTransaction, _
25           ByVal spName As String, _
26           ByVal ParamArray parameterValues() As Object)
27
28 [C#]
29 Execute *  (SqlConnection connection, CommandType commandType, 
30            string  commandText)
31
32 Execute *  (SqlConnection connection, CommandType commandType,
33            string  commandText,  params  SqlParameter[] commandParameters)
34
35 Execute *  (SqlConnection connection,  string  spName, 
36            params   object [] parameterValues)
37
38 Execute *  (SqlConnection connection, 
39           CommandType commandType,  string  commandText)
40
41 Execute *  (SqlConnection connection,
42           CommandType commandType,  string  commandText, 
43            params  SqlParameter[] commandParameters)
44
45 Execute *  (SqlConnection connection,
46            string  spName,  params   object [] parameterValues)
47

除这些重载以外，除 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 " );

 

 

转载地址：http://www.cnblogs.com/lc329857895/archive/2007/10/09/918603.html