C#怎么使用Dapper C# Dapper ORM连接数据库方法_网络技术

C#怎么使用Dapper C# Dapper ORM连接数据库方法

发布时间 - 2026-01-29 00:00:00 点击率：次

Dapper 是基于 ADO.NET 的轻量级高性能 .NET ORM，仅作极简封装，支持参数化查询与执行，不生成 SQL、不管理实体生命周期；需手动引用数据库驱动，通过 IDbConnection 扩展方法操作，强调控制力与性能。

Dapper 是一个轻量级、高性能的 .NET ORM（对象关系映射）库，它不替代 ADO.NET，而是在其基础上做了极简封装，通过扩展方法直接操作 IDbConnection。它不生成 SQL、不管理实体生命周期、不支持懒加载，但执行快、学习成本低、控制力强。

安装 Dapper 包

在项目中通过 NuGet 安装：

Visual Studio：右键项目 → “管理 NuGet 包” → 搜索 Dapper → 安装
命令行（.NET CLI）：dotnet add package Dapper
注意：Dapper 本身只依赖 System.Data.Common，无需额外数据库驱动包 —— 但你得自己引用对应数据库的 ADO.NET 驱动，比如 Microsoft.Data.SqlClient（SQL Server）、Npgsql（PostgreSQL）或 MySqlConnector（MySQL）

基础连接与查询（以 SQL Server 为例）

你需要一个打开的数据库连接（IDbConnection），Dapper 的所有扩展方法都挂在这个接口上：

创建连接字符串（例如 SQL Server）："Server=localhost;Database=TestDB;Trusted_Connection=true;"
用 using 确保连接释放：using var conn = new SqlConnection(connectionString);
执行查询：var users = conn.Query("SELECT * FROM Users WHERE Age > @age", new { age = 18 });
插入数据：int rows = conn.Execute("INSERT INTO Users (Name, Age) VALUES (@name, @age)", new { name = "张三", age = 25 });
参数一律用 @参数名 占位符，Dapper 自动处理参数化防止 SQL 注入

常用操作速查

Query()：返回多条记录（如 IEnumerable）
QuerySingle()：必须返回且仅返回 1 条，否则抛异常
QueryFirstOrDefault()：返回第一条或 null（推荐用于可能无结果的场景）
Execute()：执行 INSERT/UPDATE/DELETE，返回影响行数
QueryMultiple()：一次执行多个 SQL（用

分号分隔），返回 GridReader，适合关联查询减少往返

例如联合查用户和订单：var multi = conn.QueryMultiple("SELECT * FROM Users; SELECT * FROM Orders"); var users = multi.Read(); var orders = multi.Read();
注意：GridReader 必须按顺序读取，且不能跳过某一部分

小贴士与避坑提醒

Dapper 不自动映射字段大小写，数据库列名需与 C# 属性名**完全匹配**（默认区分大小写），常见解决方式：

用 SQL 别名：SELECT Id AS ID, UserName AS Name FROM Users
配置全局映射规则（需自定义 IDbConnection 扩展或使用第三方适配器如 Dapper.FluentMap）
确保实体属性是 public get/set，私有字段不会被映射
异步方法存在（如 QueryAsync、ExecuteAsync），推荐 Web/API 场景使用
别把 Dapper 当全自动 ORM —— 它不跟踪变更、不缓存、不建表，SQL 和事务逻辑仍需你把控

基本上就这些。Dapper 的核心就是“连接 + SQL 字符串 + 参数对象”，没有魔法，但足够快、足够稳。

# mysql # app # 懒加载 # microsoft # c# # .net # sql # NULL # 封装 # select # 字符串 # int # 接口 # using # public # var # delete # 对象 # 异步 # visual studio # database # postgresql # 数据库 # 它不 # 高性能 # 是一个 # 是在 # 多个 # 右键 # 自定义 # 不支持 # 为例 # 挂在

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：Win11怎么修复蓝牙鼠标连接卡顿_Windows11电源管

下一篇：Vue 3 中实现多个独立模态框状态管理的可复用组合式函数方

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：Win11怎么修复蓝牙鼠标连接卡顿_Windows11电源管

下一篇：Vue 3 中实现多个独立模态框状态管理的可复用组合式函数方