.NET如何使用Dapper执行原生SQL查询_Dapper执行SQL查询指南

来源：这里教程网时间：2026-02-21 17:30:53 作者：

在.NET开发中，Dapper是一个轻量级、高性能的ORM（对象关系映射）工具，特别适合执行原生SQL查询。它直接扩展了

IDbConnection

接口，让你可以用简洁的代码与数据库交互，同时保留对SQL的完全控制权。下面是如何使用Dapper执行原生SQL查询的实用指南。

安装Dapper

Dapper不是内置库，需要通过NuGet包管理器安装：

在Visual Studio中：打开“NuGet包管理器”，搜索 Dapper 并安装。 或使用命令行： Install-Package Dapper

安装完成后，你就可以在项目中引用

using Dapper;

来使用其扩展方法。

执行查询：Query和QueryAsync

Dapper最常用的查询方法是

Query

和异步版本

QueryAsync

，用于从数据库读取数据并映射到强类型对象。

示例：查询用户列表

var sql = "SELECT Id, Name, Email FROM Users WHERE Age > @Age";
using (var connection = new SqlConnection(connectionString))
{
var users = await connection.QueryAsync(sql, new { Age = 18 });
// users 是 IEnumerable
}

说明：

User
是一个具有
Id
、
Name
、
Email
属性的类，属性名需与字段名匹配（或使用别名）。
@Age
是参数化查询，防止SQL注入，传入匿名对象作为参数。

执行非查询语句：Execute和ExecuteAsync

对于INSERT、UPDATE、DELETE等不返回结果集的操作，使用

Execute

或

ExecuteAsync

。

示例：插入一条记录

var sql = "INSERT INTO Users (Name, Email, Age) VALUES (@Name, @Email, @Age)";
using (var connection = new SqlConnection(connectionString))
{
    var rowsAffected = await connection.ExecuteAsync(sql, new
    {
        Name = "张三",
        Email = "zhangsan@example.com",
        Age = 25
    });
    // rowsAffected 返回受影响的行数
}

该方法也支持批量操作：

var users = new[]
{
new { Name = "A", Email = "a@ex.com", Age = 20 },
new { Name = "B", Email = "b@ex.com", Age = 22 }
};
await connection.ExecuteAsync(sql, users);