【第4周学习笔记】设计实现SqlHelper

一、知识点描述

1.SqlHelper帮助类的简介

        SqlHelper帮助类是一个基于.NET Framework的数据库操作组件。

        SqlHelper用于简化你重复的去写那些数据库连接（SqlConnection），SqlCommand，SqlDataReader等等。SqlHelper 封装过后通常是只需要给方法传入一些参数如数据库连接字符串，SQL参数等，就可以访问数据库了，十分方便。

        SqlHelper 类用于通过一组静态方法来封装数据访问功能。该类不能被继承或实例化，因此将其声明为包含专用构造函数的不可继承类。在 SqlHelper 类中实现的每种方法都提供了一组一致的重载。这提供了一种很好的使用 SqlHelper 类来执行命令的模式，同时为开发人员选择访问数据的方式提供了必要的灵活性。每种方法的重载都支持不同的方法参数，因此开发人员可以确定传递连接、事务和参数信息的方式。

2.SqlHelper的方法

（1）公有方法

①ExecuteNonQuery
此方法用于执行不返回任何行或值的命令。这些命令通常用于执行数据库更新，但也可用于返回存储过程的输出参数。

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

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

④ExecuteScalar
此方法用于返回一个值，该值始终是该命令返回的第一行的第一列。

⑤ExecuteXmlReader
此方法用于返回 FOR XML 查询的 XML 片段。

⑥FillDataset
此方法用于向DataSet填充数据。

⑦UpdateDataset
此方法用于执行向DataSet增、删、改的命令。

⑧CreateCommand
此方法用于创建SqlCommand。

（2）私有方法

①AttachParameters

该函数用于将所有必要的 SqlParameter 对象连接到正在运行的 SqlCommand。

②AssignParameterValues

该函数用于为 SqlParameter 对象赋值。

③PrepareCommand

该函数用于对命令的属性（如连接、事务环境等）进行初始化。

④ExecuteReader

此专用 ExecuteReader 实现用于通过适当的 CommandBehavior 打开SqlDataReader对象，以便最有效地管理与阅读器关联的连接的有效期。

3.注意点

        如果使用SqlHelper方法调用数据库存储过程，需要获取存储过程的返回值，请使用带有SqlParameter[]参数的方法，Object[]参数的方法无法获取存储过程的返回值。

二、思维导图

三、示例代码

公有类：SqlHelper代码如下：

using System.Configuration;                                                                                 //包含访问配置文件所需的配置管理器；需事先在本项目的“引用”中添加对System.Configuration的引用；
using System.Data;                                                                                          //包含Ado.Net的各类数据对象；
using System.Data.SqlClient;                                                                                //包含访问SQL Server所需的各类对象；

namespace 医到家健康服务系统
{
    
    /// <summary>
    /// 公有类：Sql助手；
    /// </summary>
    public class SqlHelper
    {
        
        /// <summary>
        /// 私有静态方法：获取SQL命令；
        /// （创建包含SQL连接的SQL命令）
        /// </summary>
        /// <param name="commandText">命令文本</param>
        /// <param name="isStoredProcedure">是否存储过程</param>
        /// <param name="sqlParameters">SQL参数数组</param>
        /// <returns>SQL命令</returns>
        private static SqlCommand GetCommand(string commandText, bool isStoredProcedure, SqlParameter[] sqlParameters)
        {
            SqlConnection sqlConnection