Easy-DotNET Easy-DotNET
🏠首页
  • 知识地图
  • 源码脑图

    • 总览
    • Program
    • WebApplication
    • Host主机
    • WebHost主机
    • 依赖注入
    • Autofac
    • Middleware中间件
    • RateLimiter限制速率
    • 响应缓存、请求解压缩
  • 设计初衷
  • 克隆
  • 类型转换
  • 日期时间
  • IO流
  • 工具类
  • 语言特性
  • 集合类
  • Codec编码
  • 文本操作
  • 数学
  • 图片
  • 网络
  • Emoji表情
  • C# 12
  • C# 11
  • C# 10
  • C# 9.0
  • C# 8.0
  • C# 早期版本
  • C# 教程
  • ORM
  • 定时任务
  • 日志
  • 认证与授权
  • Swagger
  • 对象映射
  • 熔断重试限流
  • 缓存
  • 注册发现
  • 网关
  • GraphQL
  • 更多
  • Docker

    • 简介
    • Adminer
    • Apisix
    • Apollo
    • Cassandra
    • Cerebro
    • ClickHouse
    • Consul
    • EasyMock
    • Elasticsearch
    • Emqx
    • FastDFS
    • Flink
    • Gitlab
    • Jenkins
    • Jrebel
    • MariaDB
    • MySQL
    • Percona
    • Phpmyadmin
    • PostgreSQL
    • Redis
  • Linux

    • 查看Linux系统信息
    • CentOS7调整磁盘分区
    • IO压测
    • 图形化监控工具Cockpit
  • 总览
  • 列表

    • 算法数据结构
    • API
    • 应用框架
    • 应用模板
    • 操作系统
    • 工作流
    • 入门套件
    • 示例
    • 人工智能
    • 程序集
    • Assets
    • 认证授权
    • Blazor
    • 区块链
    • 书籍
    • 自动构建
    • 报表
    • 缓存
    • 日历
    • 聊天
    • CLI
    • CLR
    • CMS
    • 代码分析和指标
    • 代码片段
    • 压缩
    • 持续集成
    • 密码学
    • 数据库
    • 数据库驱动
    • 日期时间
    • 反编译
    • 部署
    • DirectX
    • 分布式计算
    • DLR
    • 文档
    • 电商支付
    • 模拟器
    • 环境管理
    • ETL
    • 事件消息
    • Exception
    • 扩展
    • 函数式编程
    • 游戏引擎
    • GIS
    • Git工具
    • 绘图
    • GraphQL
    • GUI
    • HTML-CSS
    • HTTP
    • IDE
    • 图片处理
    • 安装工具
    • 交互式编程
    • 国际化
    • 互操作性
    • IoC
    • JS引擎
    • 日志
    • 机器学习和数据科学
    • Markdown
    • 邮件
    • 数学
    • 媒体
    • 指标
    • 微型框架
    • 最小化器
    • MVVM
    • 网络
    • 对象映射
    • Office
    • OpenAI
    • ORM
    • 包管理器
    • PDF
    • 性能分析工具
    • 协议
    • 推送通知
    • SQL构建器
    • 消息队列
    • RPC
    • 响应式编程
    • 实时通信
    • 正则表达式
    • 任务调度
    • SDK和API
    • 搜索引擎
    • 序列化
    • SMS
    • 状态机
    • 静态站点生成
    • 强命名
    • 风格指南
    • 模板引擎
    • 测试
    • 工具
    • 交易
    • UI自动测试
    • Visual Studio 插件
    • Web浏览器
    • Web框架
    • WebServers
    • WebSocket
    • Windows服务
    • WPF
    • 解析器
    • 源码生成
    • 其他
    • 资源
  • AspNetCore面试题
  • Elasticsearch面试题
  • MongoDB面试题
  • MySql面试题
  • Nginx面试题
  • RabbitMQ面试题
  • Redis面试题
  • 设计模式
  • 微服务
🧑‍💻.NET Blog
GitHub (opens new window)
🏠首页
  • 知识地图
  • 源码脑图

    • 总览
    • Program
    • WebApplication
    • Host主机
    • WebHost主机
    • 依赖注入
    • Autofac
    • Middleware中间件
    • RateLimiter限制速率
    • 响应缓存、请求解压缩
  • 设计初衷
  • 克隆
  • 类型转换
  • 日期时间
  • IO流
  • 工具类
  • 语言特性
  • 集合类
  • Codec编码
  • 文本操作
  • 数学
  • 图片
  • 网络
  • Emoji表情
  • C# 12
  • C# 11
  • C# 10
  • C# 9.0
  • C# 8.0
  • C# 早期版本
  • C# 教程
  • ORM
  • 定时任务
  • 日志
  • 认证与授权
  • Swagger
  • 对象映射
  • 熔断重试限流
  • 缓存
  • 注册发现
  • 网关
  • GraphQL
  • 更多
  • Docker

    • 简介
    • Adminer
    • Apisix
    • Apollo
    • Cassandra
    • Cerebro
    • ClickHouse
    • Consul
    • EasyMock
    • Elasticsearch
    • Emqx
    • FastDFS
    • Flink
    • Gitlab
    • Jenkins
    • Jrebel
    • MariaDB
    • MySQL
    • Percona
    • Phpmyadmin
    • PostgreSQL
    • Redis
  • Linux

    • 查看Linux系统信息
    • CentOS7调整磁盘分区
    • IO压测
    • 图形化监控工具Cockpit
  • 总览
  • 列表

    • 算法数据结构
    • API
    • 应用框架
    • 应用模板
    • 操作系统
    • 工作流
    • 入门套件
    • 示例
    • 人工智能
    • 程序集
    • Assets
    • 认证授权
    • Blazor
    • 区块链
    • 书籍
    • 自动构建
    • 报表
    • 缓存
    • 日历
    • 聊天
    • CLI
    • CLR
    • CMS
    • 代码分析和指标
    • 代码片段
    • 压缩
    • 持续集成
    • 密码学
    • 数据库
    • 数据库驱动
    • 日期时间
    • 反编译
    • 部署
    • DirectX
    • 分布式计算
    • DLR
    • 文档
    • 电商支付
    • 模拟器
    • 环境管理
    • ETL
    • 事件消息
    • Exception
    • 扩展
    • 函数式编程
    • 游戏引擎
    • GIS
    • Git工具
    • 绘图
    • GraphQL
    • GUI
    • HTML-CSS
    • HTTP
    • IDE
    • 图片处理
    • 安装工具
    • 交互式编程
    • 国际化
    • 互操作性
    • IoC
    • JS引擎
    • 日志
    • 机器学习和数据科学
    • Markdown
    • 邮件
    • 数学
    • 媒体
    • 指标
    • 微型框架
    • 最小化器
    • MVVM
    • 网络
    • 对象映射
    • Office
    • OpenAI
    • ORM
    • 包管理器
    • PDF
    • 性能分析工具
    • 协议
    • 推送通知
    • SQL构建器
    • 消息队列
    • RPC
    • 响应式编程
    • 实时通信
    • 正则表达式
    • 任务调度
    • SDK和API
    • 搜索引擎
    • 序列化
    • SMS
    • 状态机
    • 静态站点生成
    • 强命名
    • 风格指南
    • 模板引擎
    • 测试
    • 工具
    • 交易
    • UI自动测试
    • Visual Studio 插件
    • Web浏览器
    • Web框架
    • WebServers
    • WebSocket
    • Windows服务
    • WPF
    • 解析器
    • 源码生成
    • 其他
    • 资源
  • AspNetCore面试题
  • Elasticsearch面试题
  • MongoDB面试题
  • MySql面试题
  • Nginx面试题
  • RabbitMQ面试题
  • Redis面试题
  • 设计模式
  • 微服务
🧑‍💻.NET Blog
GitHub (opens new window)
npm
  • 简介
  • ORM

    • EFCore
    • Dapper
      • 特点
      • 安装
      • 使用方法
      • 示例
      • 总结
    • FreeSql
    • SqlSugar
  • 任务调度

    • Hangfire
    • Quartz
    • FluentScheduler
    • Coravel
    • Quartzmin
  • 日志

    • Serilog
    • NLog
    • Log4Net
    • Stackdriver
    • ExceptionLess
  • 身份认证与授权

    • IdentityServer4
    • Identity
    • JWTBearer
    • Auth0
    • OpenIddict
  • Swagger文档

    • Swagger
    • Swashbuckle
    • NSwag
    • ReDoc
  • 对象映射

    • AutoMapper
    • EmitMapper
    • AgileMapper
    • Mapster
  • 消息传递

    • MediatR
    • MassTransit
    • Rebus
    • NServiceBus
  • 熔断重试限流

    • Polly
    • Resilience4j
    • AkkaNET
  • 缓存

    • CsRedis
    • FreeRedis
    • EasyCaching
    • StackExchangeRedis
    • CacheCow
    • NCache
    • Memory
  • 注册发现

    • Consul
    • Nacos
    • Apollo
  • 网关

    • Ocelot
    • Kong
    • Traefik
    • Zuul
  • GraphQL

    • GraphQLPlatform
    • GraphQLdotnet
  • 更多

    • NodaTime
    • FluentAssertions
    • Humanizer
    • 爬虫-AngleSharp
    • 邮件-MailKit
  • NET微服务
  • ORM
一个大西瓜
2023-04-18
目录

Dapper

Dapper是一款由StackExchange开源的微型ORM(对象关系映射)框架。它为.NET应用程序提供了高效的数据库操作解决方案。在本文中,我们将介绍Dapper的主要特点,使用方法以及示例。

# 特点

Dapper具有以下特点:

  1. 轻量级:Dapper是一款非常轻量级的ORM框架,不需要任何复杂的配置即可使用。
  2. 高性能:Dapper的性能比许多其他ORM框架要快得多,因为它使用了动态SQL查询,并避免了大量的ORM映射代码。
  3. 易于使用:Dapper提供了一个简单而直观的API,允许您使用最少的代码轻松地执行数据库操作。
  4. 可扩展性:Dapper允许您使用自己的代码扩展其功能,从而使其更适合您的需求。

# 安装

您可以使用NuGet安装Dapper。只需运行以下命令:


Install-Package Dapper

或者,在Visual Studio中右键单击您的项目,选择“Manage NuGet Packages”,然后搜索“Dapper”。

# 使用方法

Dapper提供了一组简单而直观的方法,允许您轻松地执行数据库操作。这些方法包括:

  • Query: 用于返回一个泛型列表,其类型由查询返回的列定义。
  • QueryFirstOrDefault: 用于返回查询结果中的第一行。
  • QueryMultiple: 用于同时执行多个查询,并返回多个结果集。
  • Execute: 用于执行没有返回结果的查询。

这些方法都可以通过一个IDbConnection对象调用。IDbConnection对象可以通过多种方式创建,例如:


using(var connection = new SqlConnection(connectionString))
{
    // 使用connection对象执行查询
}

使用Dapper的最简单方法是将查询字符串和任何参数传递给Query或Execute方法,如下所示:


using(var connection = new SqlConnection(connectionString))
{
    var result = connection.Query<Person>("SELECT * FROM Persons WHERE Age = @Age", new { Age = 25 });
}

在此示例中,我们使用了一个名为“Persons”的表,其中包含一个名为“Age”的列。我们还将查询参数传递给Dapper,该参数将替换查询字符串中的占位符(即@Age)。

Dapper将自动将查询结果映射到一个名为“Person”的类中,该类定义如下:


public class Person
{
    public int Id { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }
}

在本示例中,我们使用Query方法将结果映射到一个List<Person>对象中。如果查询结果为空,则返回一个空列表。如果您只需要查询结果中的第一行,则可以使用QueryFirstOrDefault方法:


using(var connection = new SqlConnection(connectionString))
{
    var result = connection.QueryFirstOrDefault<Person>("SELECT TOP 1 * FROM Persons WHERE Age = @Age", new { Age = 25 });
}

在此示例中,我们使用QueryFirstOrDefault方法将结果映射到一个Person对象中。如果查询结果为空,则返回null。

如果您需要同时执行多个查询,并返回多个结果集,则可以使用QueryMultiple方法:


using(var connection = new SqlConnection(connectionString))
{
    var sql = "SELECT * FROM Customers; SELECT * FROM Orders";
    using(var multi = connection.QueryMultiple(sql))
    {
        var customers = multi.Read<Customer>();
        var orders = multi.Read<Order>();
    }
}

在此示例中,我们将两个查询字符串传递给QueryMultiple方法,并使用Read方法将每个结果集映射到相应的对象类型中。

最后,如果您需要执行没有返回结果的查询,则可以使用Execute方法:


using(var connection = new SqlConnection(connectionString))
{
    var result = connection.Execute("INSERT INTO Persons (FirstName, LastName, Age) VALUES (@FirstName, @LastName, @Age)", new { FirstName = "John", LastName = "Doe", Age = 30 });
}

在此示例中,我们使用Execute方法执行了一个INSERT查询,并传递了三个参数,该查询将一行插入名为“Persons”的表中。

# 示例

以下示例演示了如何使用Dapper查询和插入数据。


using System;
using System.Collections.Generic;
using System.Data;
using System.Data.SqlClient;
using System.Linq;
using Dapper;

public class Program
{
    public static void Main()
    {
        var connectionString = "<your connection string>";
        
        using(var connection = new SqlConnection(connectionString))
        {
            connection.Open();
            
            // 查询所有人的信息
            var persons = connection.Query<Person>("SELECT * FROM Persons");
            foreach(var person in persons)
            {
                Console.WriteLine("{0} {1}, Age {2}", person.FirstName, person.LastName, person.Age);
            }
            
            // 查询年龄大于等于30的人的信息
            var adults = connection.Query<Person>("SELECT * FROM Persons WHERE Age >= @Age", new { Age = 30 });
            foreach(var adult in adults)
            {
                Console.WriteLine("{0} {1}, Age {2}", adult.FirstName, adult.LastName, adult.Age);
            }
            
            // 插入一行数据
            var result = connection.Execute("INSERT INTO Persons (FirstName, LastName, Age) VALUES (@FirstName, @LastName, @Age)", new { FirstName = "Jane", LastName = "Doe", Age = 25 });
            Console.WriteLine("{0} rows affected", result);
        }
    }
}

public class Person
{
    public int Id { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }
}

在此示例中,我们首先使用Query方法查询了名为“Persons”的表中的所有人,并将结果映射到一个List<Person>对象中。然后,我们使用Query方法查询了年龄大于等于30岁的人,并使用foreach循环遍历结果。最后,我们使用Execute方法将一行数据插入到名为“Persons”的表中,并显示受影响的行数。

# 总结

Dapper是一款高效,轻量级的ORM框架,适用于.NET应用程序。它提供了一组简单而直观的API,允许您轻松地执行数据库操作。Dapper的性能比许多其他ORM框架要快得多,因为它使用了动态SQL查询,并避免了大量的ORM映射代码。此外,Dapper还具有良好的可扩展性,允许您使用自己的代码扩展其功能,从而使其更适合您的需求。

上次更新: 2023/04/26, 22:10:06
EFCore
FreeSql

← EFCore FreeSql→

Theme by Vdoing | Copyright © 2019-2024 一个大西瓜 | MIT License | 苏ICP备2023013501号
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式