.net - 缓冲参数在 Dapper dot net 中起什么作用？

Question

Dapper dot net 有一个 buffer 参数(bool)，但据我所知，它唯一做的事情就是在返回之前将结果转换为列表它。

根据 documentation :

Dapper's default behavior is to execute your sql and buffer the entire reader on return. This is ideal in most cases as it minimizes shared locks in the db and cuts down on db network time.

However when executing huge queries you may need to minimize memory footprint and only load objects as needed. To do so pass, buffered: false into the Query method.

我不确定如何将结果转换为列表来实现这一点。我错过了什么吗？我唯一的想法是，它应该将 ExecuteReader 的 CommandBehavior 设置为 CommandBehavior.SequentialAccess (但事实并非如此)。

Answer 1

but as far as I can tell the only thing it does is cast the result to a list before returning it

你没有错过任何东西。这是关键的区别。但它不是这样的强制转换:实际返回的对象非常不同。基本上，有两种读取数据的方式:

• 在流式 API 中，每个元素都是单独生成的；这是非常高效的内存效率，但是如果您对每个项目进行大量后续处理，则意味着您的连接/命令可能会长时间处于“事件”状态
• 在缓冲 API 中，所有行都会在生成任何内容之前读取

如果您正在读取大量数据(数千到数百万行)，则非缓冲 API 可能更可取。否则会使用大量内存，并且在第一行可用之前可能会出现明显的延迟。但是，在大多数常见情况下，读取的数据量都在合理的范围内，因此在将其传递给调用者之前将其插入列表中是合理的。这意味着命令/读取器等在返回之前已完成。

顺便说一句，缓冲模式还避免了常见的“连接上已经有一个打开的读取器”(或任何确切的措辞)。