Teddy‘s Knowledge Base

最新推荐文章于 2026-06-29 03:30:00 发布

原创最新推荐文章于 2026-06-29 03:30:00 发布 · 835 阅读

17 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#y5M5N

撤说旱铣比 90% 的人细心的大伙伴一定发现了 DbContext 类有一个方法叫 FromExpression，它到底干吗用的？官方文档中没有专门的介绍（只在表值函数映射的例子中看到）。

咱们先来看看此方法的签名：

IQueryable FromExpression(Expression>> expression)

看着好像很复杂的样子。其实不，咱们来拆解一下：

1、TResult 是类型参数（泛型的知识点没忘吧），这里其实指的就是实体类型，比如，你的爱狗 Dog。

2、这个方法返回 IQueryable 类型，说明允许你使用 LINQ 查询。

3、重点理解其参数——Expression 表达有个万能规律：可以把与 TDelegate 类型兼容的 lambda 表达式直接赋值给 Expression<> 变量。即这个 FromExpression 方法可以使用以下 lambda 表达式作为参数：

() => [返回 IQueryable]

这个委托的意思就是：它，单身狗（无参数）一枚，但可以生产 IQueryable 对象。

哦，说了一大堆，还没说这个方法到底有啥毛用。它的用处就是你可以指定一个表达式，让 EF 一开始就返回筛选过的查询。在 DbContext 的派生类中声明 DbSet 类型的带 get + set 的公共属性这种生成首个查询（根查询）是最常用的方案，这个相信大伙们都很熟了，EF Core 最基础操作，老周就不多介绍了。假如你要对查询的初始数据做筛选，那么，按照 DbSet 的方案，要先执行一下 SELECT **** FROM #$$#*& 语句，然后再执行 SELECT **** FROM &*^$ WHERE xxxxx，我还没操作数据呢就执行了两次 SELECT 语句了。所以说，如果你一开始并不打算提取所有数据，那么直接从一开始就执行 SELECT **** FROM xxxx WHERE yyyy 多好，何必多浪费一条 SQL 语句？

还有一种使用场景：你的数据不是从某个表 SELECT 出来的，而是从一个表值函数返回的，这种情况也要借助 FromExpression 方法。

不知道老周以上说明你是否明白？不明白没关系，咱们实战一下你就懂了。

咱们先定义的实体：

复制代码

///

/// 妖书实体

///

public class Book

{

///

/// 标识 + 主键

///

public Guid BookId { get; set; }

///

/// 书名

///

public string Title { get; set; } = string.Empty;

///

/// 简介

///

public string? Description { get; set; }

///

/// 作者

///

public string Author { get; set; } = string.Empty;

}

复制代码

然后，继承 DbContext 类，常规操作。

复制代码

public class MyDbContext : DbContext

{

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)

{

optionsBuilder.UseSqlServer("Server=.\\TEST;Database=mydb;Integrated Security=True;Trust Server Certificate=True");

// 配置日志

//.LogTo(log => Debug.WriteLine(log));

}

protected override void OnModelCreating(ModelBuilder modelBuilder)

{

modelBuilder.Entity(t =>

{

t.ToTable("books", tb =>

{

tb.Property(x => x.BookId).HasColumnName("book_id");

tb.Property(z=>z.Title).HasColumnName("title");

tb.Property(k => k.Description).HasColumnName("desc");

tb.Property(f => f.Author).HasColumnName("author");

})

.HasKey(t => t.BookId);

});

}

// 以下行现在不需要了

//public DbSet Books { get; set; }

public IQueryable MyBooks

=> FromExpression(() => Set().Where(x => x.Author == "老周"));

}

复制代码

这里不用再定义 DbSet<> 类型的属性了，因为我们要对数据进行筛选，重点看 MyBooks 属性的实现：

public IQueryable MyBooks

=> FromExpression(() => Set().Where(x => x.Author == "老周"));

Set() 方法的调用会让 DbContext 自动在缓存字典中添加数据集合，然后一句 Where 做出筛选，上述代码的意思是只查询老周写的妖书，其他作者的不考虑。这时候 DbContext 不会发出 select * from xxx SQL 语句，所以你不用担心执行多余的 SQL。调用 FromExpression 方法后，会使初始查询直接生成 Select * from xxx where ...... 语句，只查询一次。

现在往 SQL Server 中新建 mydb 数据库，并创建 books 表。

复制代码

CREATE TABLE [dbo].[books] (

[book_id] UNIQUEIDENTIFIER DEFAULT (newid()) NOT NULL,

[title] NVARCHAR (35) NOT NULL,

[desc] NVARCHAR (100) NULL,

[author] NVARCHAR (20) NOT NULL,

PRIMARY KEY CLUSTERED ([book_id] ASC)

);

复制代码

顺便向表中插入些测试数据。

insert into books (title, author, [desc])

values (N'R语言从盗墓到考古', N'张法师', N'一套不正经的R语言退隐教程'),

(N'疯言疯语之HTML 6.0', N'老周', N'提前一个世纪出现的超文本协议'),

(N'程序员风水学', N'孙电鹰', N'先匪后将的他，曾有“东陵大盗”之称，在盗掘过程中他学会了用风水理论去Debug项目'),

(N'鸡形机器人编程入门', N'老周', N'未来，由于长期不种植作物，人类只能躺在病床上依靠吮吸预制营养液维持生命；后有人提出开发鸡形机器人，帮助人类进食')

现在，咱们试一下。

using var context = new MyDbContext();

foreach(Book bk in context.MyBooks)

{

Console.WriteLine($"{bk.Author,-10}{bk.Title}");

}

如果日志启用，那么，你会看到，DbContext 从初始化到 foreach 循环访问数据，只生成了一条 SQL 语句。

SELECT [b].[book_id], [b].[author], [b].[desc], [b].[title]

FROM [books] AS [b]

WHERE [b].[author] = N'老周'

下面来看看另一种应用情形——映射表值函数。

先在 SQL Server 中创建一个内联表值函数，名为 get_all_books，返回表中所有行。

CREATE FUNCTION [dbo].[get_all_books]()

RETURNS TABLE

RETURN select * from dbo.books;

回到 .NET 项目，咱们要映射一下函数。

A、先在 DbContext 的派生类中定义一个方法，用于映射到函数，不需要实现方法体，直接抛异常就行。

internal IQueryable GetAllBooksMap()

{

throw new NotSupportedException();

}

实际上，EF Core 并不会真正调用方法，只是通过生成表达式树 + 反射出方法名，然后再找到与方法名对应的数据库中的函数罢了。所以，方法不需要实现代码。

B、OnModelCreating 方法要改一下，映射列名的 HasColumnName 方法不能在 ToTable 方法中配置，否则表值函数返回的实体不能正确映射。

复制代码

modelBuilder.Entity(t =>

{

t.ToTable("books");

t.HasKey(t => t.BookId);

t.Property(x => x.BookId).HasColumnName("book_id");

t.Property(z => z.Title).HasColumnName("title");

t.Property(k => k.Description).HasColumnName("desc");

t.Property(f => f.Author).HasColumnName("author");

});

复制代码

也就是列名映射要在 Property 上配置，不能在 TableBuilder 上配置。

C、HasDbFunction 映射函数。

// 注意数据库中的函数名与类方法不同

modelBuilder.HasDbFunction(GetType().GetMethod(nameof(GetAllBooksMap), BindingFlags.NonPublic)!).HasName("get_all_books");

这里有个误区：很多大伙伴以为这样就完事了，然后就开始调用代码了。

using var context = new MyDbContext();

foreach(Book bk in context.GetAllBooksMap())

{

Console.WriteLine($"{bk.Author,-10}{bk.Title}");

}

你以为这样是对的，但运行后就是错的。上面不是说了吗？GetAllBooksMap 方法是没有实现的，你不能直接调用它！不能调用，不能调用，不能调用！！

我们还需要再给 DbContext 的派生类再定义一个方法，使用 FromExpression 方法让 GetAllBooksMap 转为表达式树。

public IQueryable GetAllBooks()

{

return this.FromExpression(() => GetAllBooksMap());

}

这么一来，GetAllBooksMap() 就成了表达式树，EF 不会真的调用它，只是获取相关信息，再翻译成 SQL。

然后这样用：

using var context = new MyDbContext();

foreach(Book bk in context.GetAllBooks())

{

Console.WriteLine($"{bk.Author,-10}{bk.Title}");

}

看，四条记录就读出来了。

image

可是，你也发现了，这TM太麻烦了，为了表值函数映射，我要封装两个方法成员。其实，这里可以把两个方法合成一个：

public IQueryable GetAllBooks()

{

return this.FromExpression(() => GetAllBooks());

}

由于是公共方法，OnModelCreating 中的 HasDbFunction 代码也可以精简一下。

modelBuilder.HasDbFunction(GetType().GetMethod(nameof(GetAllBooks))!).HasName("get_all_books");

这时候你又搞不懂了，What？GetAllBooks 方法怎么自己调用了自己？不不不，没有的事，你又忘了，FromExpression 只是转换为表达式树，并不会真的调用它。所以，这样合并后，其实代码是这样走的：

1、访问 context.GetAllBooks() ，这时候，GetAllBooks 方法确实被调用了，是你的代码调用的，不是EF调用；

2、GetAllBooks 方法被你调用后，FromExpression 方法被调用；

3、FromExpression 方法参数中，lambda 表达式虽然又引用了一次 GetAllBooks 方法，但这一次它不会被调用，EF Core 只是用来获取方法名。

现在明白了吗？

对，微软官方文档中的示例用的就是这种合并的方法，表面上看好像自己调用了自己，实则不会。

好了，今天就水到这里。