ADO.NET中SQL绑定变量方式总结

最近在项目上遇到几个问题，关于ADO.NET中SQL绑定变量
总结一下，分享给大家。
1. 使用 SqlParameter（推荐方式，防止 SQL 注入）

ADO.NET 提供 SqlParameter 来绑定变量，从而提高安全性和性能。

• 防止 SQL 注入攻击。
  
• 支持各种数据类型，避免 SQL 解析器重新编译。
  

1. using System;
2. using System.Data;
3. using System.Data.SqlClient;
5. class Program
6. {
7.     static void Main()
8.     {
9.         string connectionString = "your_connection_string";
10.         string query = "SELECT * FROM Users WHERE Username = @Username";
12.         using (SqlConnection conn = new SqlConnection(connectionString))
13.         using (SqlCommand cmd = new SqlCommand(query, conn))
14.         {
15.             cmd.Parameters.Add(new SqlParameter("@Username", SqlDbType.NVarChar) { Value = "test_user" });
17.             conn.Open();
18.             using (SqlDataReader reader = cmd.ExecuteReader())
19.             {
20.                 while (reader.Read())
21.                 {
22.                     Console.WriteLine(reader["Username"]);
23.                 }
24.             }
25.         }
26.     }
27. }

复制代码

2. 使用 AddWithValue 方法

如果不需要显式指定参数类型，可以用 AddWithValue 直接传值：
cmd.Parameters.AddWithValue("@Username", "test_user");
需要注意以下2个问题：

• AddWithValue 可能导致隐式转换，影响性能（比如 int 传 nvarchar）。
  
• 适用于简单情况，但不推荐用于复杂查询。
  

3. 存储过程（Stored Procedure）+ 绑定变量

绑定变量也可以用于存储过程，提高安全性和代码复用性。

• 提高 SQL 复用性和执行效率（缓存执行计划）。
  
• 更安全，避免 SQL 注入。
  

SQL Server 端（创建存储过程）：

1. CREATE PROCEDURE GetUserByUsername
2.     @Username NVARCHAR(50)
3. AS
4. BEGIN
5.     SELECT * FROM Users WHERE Username = @Username
6. END

复制代码

C#调用代码

1. cmd.CommandType = CommandType.StoredProcedure;
2. cmd.CommandText = "GetUserByUsername";
3. cmd.Parameters.Add(new SqlParameter("@Username", SqlDbType.NVarChar) { Value = "test_user" });

复制代码

4. 批量绑定变量（Table-Valued Parameter，TVP）

如果需要传递多个值给 SQL 查询，可以使用 TVP 绑定变量，提高批量操作的性能。

• 适用于批量查询或批量插入，提高性能。
  
• 避免循环执行 SQL 语句的开销。
  

SQL Server 端（创建 TVP 类型）：

1. CREATE TYPE UserTableType AS TABLE
2. (
3.     UserId INT
4. )

复制代码

C# 代码（传递多个 UserId）：

1. DataTable userTable = new DataTable();
2. userTable.Columns.Add("UserId", typeof(int));
3. userTable.Rows.Add(1);
4. userTable.Rows.Add(2);
6. using (SqlCommand cmd = new SqlCommand("SELECT * FROM Users WHERE UserId IN (SELECT UserId FROM @UserTable)", conn))
7. {
8.     cmd.Parameters.Add(new SqlParameter("@UserTable", SqlDbType.Structured) { TypeName = "UserTableType", Value = userTable });
9. }

复制代码

以上是C# ADO.NET 绑定变量的几种常见模式和示例代码。
 
周国庆
2025/3/16

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！