0

0

Dapper如何动态构建查询条件 Dapper动态WHERE子句方法

畫卷琴夢

畫卷琴夢

发布时间:2026-01-11 09:25:02

|

689人浏览过

|

来源于php中文网

原创

dapper不支持表达式树动态拼where,但可通过字符串拼接+参数化查询安全实现:用stringbuilder构建sql、dynamicparameters管理参数、where 1=1起始、条件统一and连接,并严禁字符串内联变量防注入。

dapper如何动态构建查询条件 dapper动态where子句方法

Dapper 本身不直接支持像 Entity Framework 那样用表达式树动态拼接 WHERE 条件,但可以通过字符串拼接 + 参数化查询的方式安全、灵活地实现动态 WHERE 子句。核心原则是:**条件拼接由代码控制,SQL 参数严格分离,避免 SQL 注入。**

手动拼接 SQL + 动态参数字典

这是最常用、最可控的方式。根据业务逻辑判断哪些条件需要加入 WHERE,逐个追加 SQL 片段,并同步添加对应参数。

  • StringBuilder 或字符串插值(C# 10+)逐步构建 SQL
  • IDictionaryDynamicParameters 收集参数,确保每个参数名唯一且带前缀(如 @name、@age)
  • WHERE 后第一个条件用 WHERE 1=1 开头,后续条件统一用 AND 连接,简化逻辑判断

示例:

var sql = new StringBuilder("SELECT * FROM Users WHERE 1=1");
var parameters = new DynamicParameters();
<p>if (!string.IsNullOrWhiteSpace(name))
{
sql.Append(" AND Name LIKE @name");
parameters.Add("@name", $"%{name}%", DbType.String);
}
if (age.HasValue)
{
sql.Append(" AND Age = @age");
parameters.Add("@age", age.Value, DbType.Int32);
}
if (isActive.HasValue)
{
sql.Append(" AND IsActive = @isActive");
parameters.Add("@isActive", isActive.Value, DbType.Boolean);
}</p><p>var users = connection.Query<User>(sql.ToString(), parameters).ToList();
</font></p><H3>使用 Dapper.FastCRUD(第三方扩展)</H3><p>如果你希望更接近 ORM 的写法,<strong>Dapper.FastCRUD</strong> 提供了基于表达式的 Where 构建器,支持链式调用和部分动态条件。</p><ul><li>需安装 NuGet 包:<code>Dapper.FastCRUD</code></li><li>支持 <code>.Where(x => x.Name.Contains(name))</code> 等写法,底层仍转为参数化 SQL</li><li>对简单动态场景友好,但复杂逻辑(如 OR 分组、嵌套括号)仍需手写 SQL</li></ul><p>注意:它不是官方 Dapper 组件,需评估项目长期维护成本。</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/2430" title="飞象老师"><img
                                                                                src="https://img.php.cn/upload/ai_manual/001/246/273/176507759983966.png" alt="飞象老师"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/2430" title="飞象老师">飞象老师</a>
                                                                        <p>猿辅导推出的AI教学辅助工具</p>
                                                                </div>
                                                                <a href="/ai/2430" title="飞象老师" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div><H3>封装通用动态查询辅助类</H3><p>为避免重复写拼接逻辑,可封装一个轻量工具类,比如 <code>SqlBuilder</code>,负责管理 WHERE 条件和参数。</p><ul><li>内部维护 <code>List<string> _wheres</code> 和 <code>DynamicParameters _params</code></li><li>提供 <code>AddIf(string condition, string paramName, object value)</code> 方法,自动跳过 null/empty 值</li><li>最终调用 <code>BuildSelectSql(string table, string fields = "*")</code> 返回完整 SQL 和参数</li></ul><p>这样业务层只需关注“要不要加这个条件”,不用操心 SQL 拼写和参数命名冲突。</p><H3>慎用字符串格式化或内联变量</H3><p>绝对不要这样写:</p><font color="#888"><pre class="brush:php;toolbar:false;">
// ❌ 危险!SQL 注入漏洞
string sql = $"SELECT * FROM Users WHERE Name = '{name}'";

也不建议用 $"AND Age = {age}" 直接拼数值——即使 int 看似安全,一旦类型变更或传入恶意字符串就失控。Dapper 的安全性完全依赖参数化,绕过它就等于放弃防护底线。

基本上就这些。Dapper 的“动态 WHERE”不是靠魔法,而是靠清晰的条件分支 + 严格的参数隔离。写起来多几行,但稳定、可读、可测试。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1090

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

339

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

380

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2008

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

379

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1560

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

438

2024.04.29

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

4

2026.03.04

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java 教程
Java 教程

共578课时 | 76.9万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号