### SQLHelper类详解
#### 一、概述
`SQLHelper`类主要负责处理与数据库相关的操作，例如执行SQL语句、获取数据等。该类在.NET框架下开发，利用`System.Data.SqlClient`命名空间中的`SqlConnection`、`SqlCommand`、`SqlDataReader`等类来实现对SQL Server数据库的操作。下面将详细介绍`SQLHelper`类的关键方法和属性。
#### 二、类结构
`SQLHelper`类被声明为`sealed`，意味着它不能被继承。此类包含静态方法和私有构造函数，确保类的单例模式，并提供了一系列静态方法用于数据库操作。
#### 三、关键方法
##### 1. AttachParameters 方法
**功能**：此方法用于向`SqlCommand`对象附加参数。
**参数**：
- `command`: `SqlCommand`类型的对象，用于执行SQL命令。
- `commandParameters`: `SqlParameter`数组，代表SQL命令的参数集合。
**实现细节**：
- 首先检查`command`是否为空，如果为空则抛出`ArgumentNullException`异常。
- 如果`commandParameters`不为空，则遍历所有参数，对于每个参数：
- 如果参数的方向是输入或输入输出，并且值为空，则设置其值为`DBNull.Value`，表示SQL中NULL值。
- 将参数添加到`command`对象的参数集合中。
##### 2. AssignParameterValues 方法
**功能**：此方法用于为`SqlParameter`对象赋值。
**版本**：
- **版本一**：接受`SqlParameter`数组和`DataRow`作为参数，根据`DataRow`中的值为`SqlParameter`对象赋值。
- **版本二**：接受`SqlParameter`数组和对象数组作为参数，根据对象数组中的值为`SqlParameter`对象赋值。
**实现细节**：
- **版本一**：
- 检查`commandParameters`和`dataRow`是否都非空。
- 遍历`commandParameters`数组中的每个元素，检查每个参数名的有效性（长度至少为2）。
- 使用`dataRow`中的值为对应的`SqlParameter`赋值。
- **版本二**：
- 检查`commandParameters`和`parameterValues`是否都非空。
- 检查两个数组长度是否相等，如果不相等，则抛出`ArgumentException`异常。
- 遍历两个数组，为`SqlParameter`对象赋值。
#### 四、使用示例
假设我们有一个表`Employees`，其中包含`Id`、`Name`和`Salary`字段。下面是如何使用`SQLHelper`类来查询特定员工的信息：
```csharp
// 假设已有 SqlConnection 对象 connection
string query = "SELECT * FROM Employees WHERE Id = @Id";
SqlParameter[] commandParameters = new SqlParameter[] {
new SqlParameter("@Id", SqlDbType.Int, 4) { Value = 1 }
};
SqlCommand command = new SqlCommand(query, connection);
SqlHelper.AttachParameters(command, commandParameters);
SqlDataReader reader = command.ExecuteReader();
while (reader.Read()) {
int id = reader.GetInt32(0);
string name = reader.GetString(1);
decimal salary = reader.GetDecimal(2);
Console.WriteLine($"ID: {id}, Name: {name}, Salary: {salary}");
}
reader.Close();
```
#### 五、注意事项
- 在使用`SQLHelper`类时，需要注意正确处理数据库连接的打开和关闭。
- 参数化查询可以有效防止SQL注入攻击。
- 当处理大量数据时，应考虑性能优化问题。
通过以上介绍，我们可以看到`SQLHelper`类在.NET应用程序中处理数据库操作时的重要性。合理使用这些方法能够简化代码并提高程序的健壮性和安全性。
