C#怎么使用EF Core原生SQL查询_C# EF Core执行SQL语句方法【常用】

尼克

尼克

2026-05-10

967人浏览

原创

ef core原生sql查询必须参数化,查数据优先用fromsqlinterpolated(自动命名参数、防注入),改数据用executesqlinterpolatedasync(异步、返回影响行数);标量或dto查询用sqlqueryraw;fromsql后链式linq会触发内存过滤,应避免。

c#怎么使用ef core原生sql查询_c# ef core执行sql语句方法【常用】

EF Core 原生 SQL 查询不能直接拼字符串,必须参数化;查数据用 FromSqlRawFromSqlInterpolated,改数据用 ExecuteSqlRawExecuteSqlInterpolatedAsync

查数据:用 FromSqlRaw 还是 FromSqlInterpolated

优先选 FromSqlInterpolated——它自动把插值变量转成命名参数,不手动处理占位符,也不怕漏写 SqlParameter

  • FromSqlRaw 必须显式传参,比如 "SELECT * FROM Users WHERE Age > {0}" 后跟 18,但若混入用户输入又忘了参数化,极易触发 SQL 注入
  • FromSqlInterpolated 写法更自然:$"SELECT * FROM Users WHERE Name LIKE {searchTerm}",EF Core 底层自动包装为 @p0 参数,安全且不易出错
  • 两者都只能用于 DbSet<t></t>,返回类型必须是已映射的实体类(或其可映射基类/接口),不能直接返回匿名对象
  • 如果只是读取展示,加上 .AsNoTracking() 能省掉变更跟踪开销,尤其对大结果集明显

改数据:为什么不能用 FromSqlRaw 执行 UPDATE?

FromSqlRaw 只接受以 SELECT 开头的语句,EF Core 会尝试把它映射成实体集合。执行 INSERT/UPDATE/DELETE 必须走 DbContext.Database 上的方法。

C函数速查手册(CHM版)
C函数速查手册(CHM版)

C函数速查手册(CHM版)

下载
  • ExecuteSqlRaw 或更推荐的 ExecuteSqlInterpolatedAsync(异步、自动参数化)
  • 返回值是受影响行数(int),可用于判断是否成功,比如 if (rows == 0) throw new InvalidOperationException("未找到匹配记录")
  • 原生 SQL 不触发 EF Core 的变更跟踪、验证逻辑、SaveChanges 拦截器,也不会调用实体的构造函数或属性 setter
  • 别在事务外单独开连接——复用 context.Database.GetDbConnection(),确保与 EF 的事务生命周期一致

查标量值或自定义 DTO:怎么绕过实体映射限制?

当 SQL 返回的是 COUNT(*)string、或字段名/类型不匹配实体时,FromSqlRaw 就不适用了。

  • 标量查询(如计数、求和)用 Database.SqlQueryRaw<t>()</t>,比如 context.Database.SqlQueryRaw<long>("SELECT COUNT(*) FROM Users").Single()</long>
  • 查自定义结构(非实体)需轻量 DTO:定义一个只有 public 属性或带匹配参数的构造函数的 class,再用 SqlQueryRaw<mydto></mydto>
  • SqlQueryRaw 返回的结果默认不被上下文跟踪,也不参与 EF 的状态管理,这点和 FromSqlRaw 默认行为不同
  • 注意大小写:PostgreSQL 或开启区分大小写的 SQL Server 下,列名必须和 DTO 属性名严格一致(包括大小写)

最容易忽略的一点:链式调用 .Where() 会掉进内存过滤陷阱

很多人写完 FromSqlRaw 还顺手加个 .Where(x => x.IsActive),以为 EF 会把它翻译进 SQL——其实不会。

  • EF Core 对 FromSqlRaw 后的 LINQ 方法不做翻译,而是先执行原始 SQL 把所有数据拉到内存,再用 C# 代码过滤
  • 数据量稍大就卡死,CPU 和内存飙升,线上容易出事故
  • 真要组合条件,要么把逻辑写进原始 SQL 里,要么用 FromSqlInterpolated 动态拼接 WHERE 子句(仍保持参数化)
  • 存储过程调用同理:不能在 FromSqlRaw("EXEC GetUsers") 后再加 .OrderBy(),得让存储过程自己排序

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1111

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

2283

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2154

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

2344

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

336

5

c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

528

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

1180

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

556

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

1051

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PDO数据库抽象层
PDO数据库抽象层

共7课时 | 3.3万人学习

RabbitMQ 教程手册
RabbitMQ 教程手册

共0课时 | 0人学习