EF Core FirstOrDefault怎么用 EF Core查询单条记录方法

来源:这里教程网 时间:2026-02-21 17:34:28 作者:

FirstOrDefault 是 EF Core 中最常用的查询单条记录的方法,适用于“取第一个匹配项,没找到就返回默认值”的场景。

FirstOrDefault 的基本用法

它会生成

SELECT TOP 1 ...
(SQL Server)或等效的 LIMIT 查询,只查一条数据,效率高。如果数据库中没有匹配项,不会报错,而是返回
null
(引用类型)或类型的默认值(如
0
false
)。

查询存在时返回实体对象;不存在时返回
null
(例如
Blog
类型)
查询值类型(如
int
)需配合
Select
使用,否则编译不通过
不带条件直接调用(
context.Blogs.FirstOrDefault()
)会取表中任意一条(通常第一条),慎用

带条件的 FirstOrDefault(最常用)

推荐始终加 where 条件,避免意外取到错误数据:

var blog = context.Blogs.FirstOrDefault(b => b.Id == 123);

等价于 SQL:

SELECT TOP 1 * FROM Blogs WHERE Id = 123
。如果 ID 为 123 的博客不存在,
blog
就是
null
,可安全判断:

if (blog != null)
{
    Console.WriteLine(blog.Name);
}

FirstOrDefault + Select:查单个字段

如果只要一个字段(比如只查用户名),用

Select
配合
FirstOrDefault
更高效:

string name = context.Users.FirstOrDefault(u => u.Id == 5)?.Name;
(先查整行再取 Name)
string name = context.Users.Where(u => u.Id == 5).Select(u => u.Name).FirstOrDefault();
(只查 Name 字段,推荐)

后者生成的 SQL 是

SELECT TOP 1 Name FROM Users WHERE Id = 5
,更节省网络和内存。

FirstOrDefaultAsync:异步版本(推荐用于 Web 应用)

在 ASP.NET Core 等异步环境中,优先用

FirstOrDefaultAsync
防止线程阻塞:

var product = await context.Products.FirstOrDefaultAsync(p => p.Sku == "ABC123");

记得方法签名要加

async
,返回类型为
Task<t></t>
,调用处用
await

基本上就这些。用对 FirstOrDefault,既能安全取单条,又不拖慢查询。

相关推荐