【.net/.net core】【报错处理】另一个 SqlParameterCollection 中已包含 SqlParameter。

错误场景：使用同名参数在两个SQL句柄中使用参数化查询

SqlCommand cmd1 = new SqlCommand("SELECT * FROM User WHERE ID = @UserID", conn);
cmd1.Parameters.Add(new SqlParameter("@UserID", SqlDbType.Int) { Value = 100 });

SqlCommand cmd2 = new SqlCommand("UPDATE User SET Age = 20 WHERE ID = @UserID", conn);
cmd2.Parameters.Add(new SqlParameter("@UserID", SqlDbType.Int) { Value = 100 });

解决方案：

1.清空参数

SqlCommand cmd = new SqlCommand("", conn);
// 第一次使用
cmd.CommandText = "SELECT * FROM User WHERE ID = @UserID";
cmd.Parameters.Add(new SqlParameter("@UserID", SqlDbType.Int) { Value = 100 });
cmd.ExecuteReader();

// 第二次使用（未清空参数）
cmd.CommandText = "SELECT * FROM Order WHERE UserID = @UserID";
cmd.Parameters.Add(new SqlParameter("@UserID", SqlDbType.Int) { Value = 100 }); // ❌ 重复添加同名参数（虽不是同一个实例，但也会报错"已包含名为@UserID的参数"）

// 正确写法：先清空参数
cmd.Parameters.Clear(); // ✅ 清空原有参数
cmd.CommandText = "SELECT * FROM Order WHERE UserID = @UserID";
cmd.Parameters.Add(new SqlParameter("@UserID", SqlDbType.Int) { Value = 100 });
cmd.ExecuteReader();

2.使用不同名参数进行参数化查询