Dapper的结果缓冲指将查询结果一次性加载到内存，避免多次枚举时重复访问数据库或因连接关闭报错。默认buffered: true时结果被缓存，可安全多次遍历；设为false则延迟加载，仅支持一次枚举，否则可能抛出异常。处理大数据且单次遍历时可用buffered: false节省内存，否则应保持默认以确保安全性和易用性。
在C#中使用Dapper时，查询结果默认是延迟加载的，这意味着枚举结果（如遍历foreach）会触发数据库游标逐行读取。如果你多次枚举同一个查询结果，就会导致重复执行数据库操作或抛出异常（尤其是在连接已关闭的情况下）。为了避免这个问题，Dapper提供了结果缓冲（buffering）机制。
什么是结果缓冲？
结果缓冲是指将查询结果一次性加载到内存中，而不是按需逐行读取。这样你可以安全地多次枚举结果集，也不会因为数据库连接关闭而报错。
如何启用结果缓冲？
Dapper大多数查询方法（如Query、QueryAsync）都有一个名为 buffered 的参数，默认值为 true。当设置为 true 时，Dapper 会将所有结果缓存到内存中；若设为 false，则返回的是一个延迟执行的可枚举对象。
重点：确保你理解不同设置的影响。
示例：
using (var connection = new SqlConnection(connectionString)){ // 默认 buffered = true，结果被缓存 var users = connection.Query("SELECT * FROM Users");// 可以安全地多次遍历foreach (var user in users) { /* 第一次遍历 */ }foreach (var user in users) { /* 第二次遍历 —— 安全 */ }
}
如果关闭缓冲：
using (var connection = new SqlConnection(connectionString)){ // buffered = false，延迟执行 var users = connection.Query("SELECT * FROM Users", buffered: false);foreach (var user in users) { } // 正常foreach (var user in users) { } // ❌ 错误！无法重新枚举，可能引发异常
}
为什么需要关注缓冲？
未缓冲的结果依赖于数据库连接保持打开状态。一旦连接关闭，再次枚举会失败。未缓冲适合处理大量数据，节省内存，但只能枚举一次。已缓冲允许重复访问，更符合常规集合行为，但会占用更多内存。
最佳实践建议
绝大多数场景下，使用默认的 buffered: true 即可。这是最安全、最直观的方式。当你处理非常大的结果集且只遍历一次时，可考虑 buffered: false 来降低内存压力。如果需要多次遍历结果，请务必确保启用了缓冲（即保持默认或显式设为 true）。异步方法如 QueryAsync 同样支持 buffered 参数，逻辑一致。
基本上就这些。Dapper 的缓冲机制简单但关键，理解它能避免“序列已结束”这类常见异常。只要记得：想多次遍历？必须开启缓冲。默认就是开启的，除非你手动关了它。不复杂但容易忽略。
以上就是C#中如何使用Dapper的结果缓冲？避免多次枚举？的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1439879.html
微信扫一扫 
支付宝扫一扫 
