C# 如何执行原生SQL查询 – 使用Dapper或EF Core的FromSql

12次阅读

推荐使用Dapper或EF Core执行原生sql:Dapper适用于高性能、复杂查询场景,通过Query和参数化防注入;EF Core使用FromSqlInterpolated支持安全内插查询,仅限于查询操作,写操作需用ExecuteSqlInterpolatedAsync,并始终避免SQL拼接以确保安全。

C# 如何执行原生SQL查询 – 使用Dapper或EF Core的FromSql

在 C# 中执行原生 SQL 查询,最常用且推荐的方式是通过 DapperEF Core 的 FromSqlRaw(注意:EF Core 7+ 已弃用 FromSql,统一用 FromSqlRawFromSqlInterpolated)。两者适用场景不同:Dapper 轻量直接,适合复杂查询或性能敏感场景;EF Core 更适合已建模、需结合实体生命周期的场景。

用 Dapper 执行原生 SQL

Dapper 是一个微型 ORM,基于 ADO.net 封装,支持强类型映射和参数化查询,语法简洁高效。

  • 安装 NuGet 包:Dapper
  • 确保已有 IDbConnection(如 SqlConnection),并保持打开状态
  • 使用 Query(返回多行)、QuerySingleExecute(非查询)等方法
  • 务必使用参数化查询防止 SQL 注入,避免字符串拼接

示例:

using (var conn = new SqlConnection(connectionString)) {     conn.Open();     var users = conn.Query(         "SELECT * FROM Users WHERE Age > @minAge AND Status = @status",         new { minAge = 18, status = "Active" }); }

用 EF Core 执行原生 SQL(FromSqlRaw / FromSqlInterpolated)

EF Core 允许对 DbSet 直接执行原生 SQL,但有严格限制:只能用于查询(不能用于 INSERT/UPDATE/delete),且返回类型必须与实体或投影类型匹配。

  • FromSqlRaw:接受格式化字符串,需手动处理参数占位符(如 {0} 不安全,应配合 SqlParameter
  • FromSqlInterpolated:支持内插字符串($""),自动参数化,更安全、更推荐
  • 原生 SQL 不能包含分号(除非启用 EnableSensitiveDataLogging 并配置允许)
  • 不支持复杂 JOIN 或子查询直接映射到非实体类型,必要时可用 AsEnumerable() 后续处理

示例:

var minAge = 18; var status = "Active"; 

var users = context.Users .FromSqlInterpolated($"SELECT * FROM Users WHERE Age > {minAge} AND Status = {status}") .ToList();

执行非查询类原生 SQL(INSERT/UPDATE/DELETE)

无论是 Dapper 还是 EF Core,都不通过 FromSql 做写操作。

  • Dapper:用 Execute 方法,返回影响行数
  • EF Core:用 database.ExecuteSqlRawDatabase.ExecuteSqlInterpolated
  • 两者都支持异步版本(ExecuteAsync / ExecuteSqlRawAsync

示例(EF Core):

var rows = await context.Database.ExecuteSqlInterpolatedAsync(     $"UPDATE Users SET Status = {newStatus} WHERE Id = {userId}");

安全与注意事项

原生 SQL 灵活但风险高,关键点要牢记:

  • 永远不要拼接用户输入到 SQL 字符串中,必须用参数化
  • Dapper 的匿名对象参数、EF Core 的内插字符串会自动转义,是安全选择
  • EF Core 的 FromSql* 只能作用于根 DbSet,不能链式调用 Wherelinq 方法后再用 FromSql
  • 若需动态表名或列名(如分表场景),无法参数化,需白名单校验 + 自定义规则过滤

基本上就这些。选 Dapper 还是 EF Core,取决于你是否需要实体跟踪、变更检测、迁移等高级功能——轻量查用 Dapper,业务模型重、需统一 ORM 体验就用 EF Core 的原生 SQL 支持。

text=ZqhQzanResources