【C#生态园】一文详解：NHibernate、Entity Framework Core、Dapper 等 .NET ORM 框架优劣对比

选择最佳工具：全面比较 .NET ORM 框架的优劣

前言

在 .NET 开发中，ORM（对象关系映射）框架扮演着至关重要的角色，它们为开发人员提供了便捷的数据库操作方式，使得面向对象的编程与关系型数据库之间的映射更加简单和高效。本文将对几种常用的 .NET ORM 框架进行介绍和比较，帮助读者在实际项目中选择最适合的解决方案。

欢迎订阅专栏：C#生态园

文章目录

[选择最佳工具：全面比较 .NET ORM 框架的优劣](#选择最佳工具：全面比较 .NET ORM 框架的优劣)
- 前言
- [1. NHibernate：一个用于 .NET 的对象关系映射解决方案](#1. NHibernate：一个用于 .NET 的对象关系映射解决方案)
- - [1.1 简介](#1.1 简介)
  - - [1.1.1 核心功能](#1.1.1 核心功能)
    - [1.1.2 使用场景](#1.1.2 使用场景)
  - [1.2 安装与配置](#1.2 安装与配置)
  - - [1.2.1 安装指南](#1.2.1 安装指南)
    - [1.2.2 基本配置](#1.2.2 基本配置)
  - [1.3 API 概览](#1.3 API 概览)
  - - [1.3.1 实体映射](#1.3.1 实体映射)
    - [1.3.2 查询语言](#1.3.2 查询语言)
- [2. Entity Framework Core：一个轻量级的、可扩展的 .NET ORM](#2. Entity Framework Core：一个轻量级的、可扩展的 .NET ORM)
- - [2.1 简介](#2.1 简介)
  - - [2.1.1 核心功能](#2.1.1 核心功能)
    - [2.1.2 使用场景](#2.1.2 使用场景)
  - [2.2 安装与配置](#2.2 安装与配置)
  - - [2.2.1 安装方法](#2.2.1 安装方法)
    - [2.2.2 基本设置](#2.2.2 基本设置)
  - [2.3 API 概览](#2.3 API 概览)
  - - [2.3.1 数据上下文](#2.3.1 数据上下文)
    - [2.3.2 实体关系](#2.3.2 实体关系)
- [3. Dapper：一款高性能的微型ORM](#3. Dapper：一款高性能的微型ORM)
- - [3.1 简介](#3.1 简介)
  - - [3.1.1 核心功能](#3.1.1 核心功能)
    - [3.1.2 使用场景](#3.1.2 使用场景)
  - [3.2 安装与配置](#3.2 安装与配置)
  - - [3.2.1 安装指南](#3.2.1 安装指南)
    - [3.2.2 基本配置](#3.2.2 基本配置)
  - [3.3 API 概览](#3.3 API 概览)
  - - [3.3.1 SQL查询](#3.3.1 SQL查询)
    - [3.3.2 参数化查询](#3.3.2 参数化查询)
- [4. FluentNHibernate：NHibernate的对象映射增强库](#4. FluentNHibernate：NHibernate的对象映射增强库)
- - [4.1 简介](#4.1 简介)
  - - [4.1.1 核心功能](#4.1.1 核心功能)
    - [4.1.2 使用场景](#4.1.2 使用场景)
  - [4.2 安装与配置](#4.2 安装与配置)
  - - [4.2.1 安装指南](#4.2.1 安装指南)
    - [4.2.2 基本设置](#4.2.2 基本设置)
  - [4.3 API 概览](#4.3 API 概览)
  - - [4.3.1 映射配置](#4.3.1 映射配置)
    - [4.3.2 自动映射](#4.3.2 自动映射)
- [5. LLBLGen Pro：一个商业级ORM框架](#5. LLBLGen Pro：一个商业级ORM框架)
- - [5.1 简介](#5.1 简介)
  - - [5.1.1 核心功能](#5.1.1 核心功能)
    - [5.1.2 使用场景](#5.1.2 使用场景)
  - [5.2 安装与配置](#5.2 安装与配置)
  - - [5.2.1 安装指导](#5.2.1 安装指导)
    - [5.2.2 基本配置](#5.2.2 基本配置)
  - [5.3 API 概览](#5.3 API 概览)
  - - [5.3.1 实体模型设计](#5.3.1 实体模型设计)
    - [5.3.2 查询构建](#5.3.2 查询构建)
- [6. PetaPoco：一个轻量级的微ORM库](#6. PetaPoco：一个轻量级的微ORM库)
- - [6.1 简介](#6.1 简介)
  - - [6.1.1 核心功能](#6.1.1 核心功能)
    - [6.1.2 使用场景](#6.1.2 使用场景)
  - [6.2 安装与配置](#6.2 安装与配置)
  - - [6.2.1 安装指南](#6.2.1 安装指南)
    - [6.2.2 基本设置](#6.2.2 基本设置)
  - [6.3 API 概览](#6.3 API 概览)
  - - [6.3.1 CRUD操作](#6.3.1 CRUD操作)
    - [6.3.2 批量操作](#6.3.2 批量操作)
- 总结

1. NHibernate：一个用于 .NET 的对象关系映射解决方案

1.1 简介

NHibernate 是一个成熟的开源对象关系映射 (ORM) 解决方案，它为 .NET 应用程序提供了强大的数据库访问功能。通过 NHibernate，开发者可以将面向对象的编程语言与关系型数据库进行无缝集成，简化了数据持久化的过程。

1.1.1 核心功能

对象到关系数据库的映射
自定义查询语言（HQL）
缓存
事务管理
透明的延迟加载

NHibernate 官网链接：NHibernate

1.1.2 使用场景

NHibernate 通常用于开发需要与数据库交互的 .NET 应用程序，特别是那些使用面向对象编程语言的项目。

1.2 安装与配置

在使用 NHibernate 前，需要先安装并进行基本的配置。

1.2.1 安装指南

使用 NuGet 包管理器可轻松安装 NHibernate：

bash 复制代码

Install-Package NHibernate

1.2.2 基本配置

csharp 复制代码

// NHibernate 配置
var configuration = new Configuration();
configuration.Configure(); // 从默认位置加载配置文件

ISessionFactory sessionFactory = configuration.BuildSessionFactory();

1.3 API 概览

NHibernate 提供了丰富的 API 来进行实体映射和数据库操作。

1.3.1 实体映射

csharp 复制代码

// 实体映射示例
public class Product
{
    public virtual int Id { get; set; }
    public virtual string Name { get; set; }
    public virtual decimal Price { get; set; }
}

// 映射配置文件
<class name="Product" table="Products">
  <id name="Id" column="ProductId" type="int">
    <generator class="identity"/>
  </id>
  <property name="Name" column="ProductName" type="string" not-null="true"/>
  <property name="Price" column="ProductPrice" type="decimal" not-null="true"/>
</class>

1.3.2 查询语言

NHibernate 支持 HQL（Hibernate Query Language）来进行高级查询。

csharp 复制代码

// 使用 HQL 示例
var query = session.CreateQuery("FROM Product p WHERE p.Price > :price");
query.SetParameter("price", 100.00);
var results = query.List<Product>();

以上是 NHibernate 的简要介绍、安装配置以及 API 演示。详细内容请参考 NHibernate 文档。

2. Entity Framework Core：一个轻量级的、可扩展的 .NET ORM

2.1 简介

Entity Framework Core 是 Microsoft 推出的一款开源的对象关系映射（ORM）框架，它是 Entity Framework 的轻量级版本，专为 .NET Core 开发。它支持多种数据库，并提供了强大的查询语言和数据变更跟踪功能。

2.1.1 核心功能

Entity Framework Core 提供了数据模型到数据库表的映射，LINQ 查询，以及对数据库的修改和更新等功能。它还支持数据库迁移，允许开发人员轻松地管理数据库结构变更。

2.1.2 使用场景

Entity Framework Core 适用于需要与数据库交互的 .NET Core 应用程序，包括 Web 应用、桌面应用和移动应用等。

2.2 安装与配置

2.2.1 安装方法

你可以通过 NuGet 包管理器或者 .NET CLI 来安装 Entity Framework Core。在 Package Manager Console 中执行以下命令安装 Entity Framework Core：

csharp 复制代码

Install-Package Microsoft.EntityFrameworkCore

2.2.2 基本设置

在使用 Entity Framework Core 之前，你需要定义一个继承自 DbContext 类的数据上下文，并指定要映射的实体类型。此外，你还需要在应用程序的配置中指定数据库提供程序和连接字符串等信息。

2.3 API 概览

2.3.1 数据上下文

数据上下文是 Entity Framework Core 中的核心组件，它代表了一个数据库会话，负责管理实体对象与数据库之间的映射和交互。以下是一个简单的数据上下文类的示例代码：

csharp 复制代码

public class MyDbContext : DbContext
{
    public DbSet<Student> Students { get; set; }
    public DbSet<Course> Courses { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("your_connection_string");
    }
}

在这个示例中，MyDbContext 继承自 DbContext，并包含了两个属性 Students 和 Courses，分别表示了学生和课程实体。

2.3.2 实体关系

Entity Framework Core 允许通过 Fluent API 或者数据注解来定义实体之间的关系。下面是一个使用 Fluent API 来定义实体关系的示例：

csharp 复制代码

public class Student
{
    public int Id { get; set; }
    public string Name { get; set; }
    public ICollection<Course> Courses { get; set; }
}

public class Course
{
    public int Id { get; set; }
    public string Name { get; set; }
    public ICollection<Student> Students { get; set; }
}

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Student>()
        .HasMany(s => s.Courses)
        .WithMany(c => c.Students)
        .UsingEntity(j => j.ToTable("StudentCourse"));
}

在这个示例中，Student 和 Course 之间是多对多的关系，使用 HasMany() 和 WithMany() 方法来定义实体之间的关系。

以上是 Entity Framework Core 的简单介绍和基本使用示例。你可以在 Entity Framework Core 官方文档中找到更多详细的信息和示例。

3. Dapper：一款高性能的微型ORM

3.1 简介

Dapper 是一个轻量级、快速的对象关系映射(ORM)工具，它是由 Stack Overflow 团队开发并维护的。相比 Entity Framework 等 ORM 工具，Dapper 更加轻巧且性能出众。

3.1.1 核心功能

Dapper 提供了快速的数据访问操作，并且通过对象关系映射的方式将数据库中的数据映射成对象，也可以将对象转换为 SQL 语句执行在数据库中。

3.1.2 使用场景

Dapper 适用于需要高性能数据访问的场景，例如对于大量数据进行快速查询和操作，以及对于需要精细化控制 SQL 的场景。

3.2 安装与配置

3.2.1 安装指南

你可以通过 NuGet 来安装 Dapper，打开 Visual Studio 的 NuGet 包管理器控制台，输入以下命令进行安装：

bash 复制代码

Install-Package Dapper

3.2.2 基本配置

使用 Dapper 非常简单，只需引入 Dapper 命名空间即可开始使用其提供的功能。

csharp 复制代码

using Dapper;

3.3 API 概览

3.3.1 SQL查询

Dapper 提供了一种直接执行 SQL 查询的方法，下面是一个简单的示例：

csharp 复制代码

var sql = "SELECT * FROM Users WHERE Id = @Id";
var user = connection.QueryFirstOrDefault<User>(sql, new { Id = 1 });

在这个示例中，我们使用 QueryFirstOrDefault 方法执行 SQL 查询，并通过匿名对象传递参数 Id。

3.3.2 参数化查询

Dapper 也支持参数化查询，这样可以防止 SQL 注入攻击。下面是一个参数化查询的示例：

csharp 复制代码

var sql = "SELECT * FROM Orders WHERE OrderDate > @OrderDate";
var orders = connection.Query<Order>(sql, new { OrderDate = new DateTime(2021, 1, 1) });

在这个示例中，我们使用 Query 方法执行参数化查询，传递了一个包含参数 OrderDate 的匿名对象。

更多关于 Dapper 的使用，你可以参考官方文档：Dapper 官网

以上是关于 Dapper 的简要介绍，希望对你有所帮助！

4. FluentNHibernate：NHibernate的对象映射增强库

4.1 简介

FluentNHibernate 是 NHibernate 的对象关系映射（ORM）库的一个增强版本，它通过流畅的接口提供了更简洁、更易于维护的方式来进行对象映射。

4.1.1 核心功能

FluentNHibernate 提供了一种用流畅的语法来配置 NHibernate 映射信息的方法，使得代码更加清晰易懂。它还支持自动映射，可以根据约定快速地实现对象到数据库表的映射。

4.1.2 使用场景

FluentNHibernate 适用于需要使用 NHibernate 进行数据持久化的项目，并且希望通过简洁的代码来配置和管理映射信息的开发者。

4.2 安装与配置

4.2.1 安装指南

FluentNHibernate 可以通过 NuGet 包管理器进行安装，可以在 Visual Studio 中的 NuGet 包管理器控制台中执行以下命令进行安装：

bash 复制代码

Install-Package FluentNHibernate

4.2.2 基本设置

要开始使用 FluentNHibernate，首先需要创建一个定义映射信息的类，并通过 FluentNHibernate 的 API 来配置映射信息。

4.3 API 概览

4.3.1 映射配置

下面是一个基本的 FluentNHibernate 映射配置的示例：

csharp 复制代码

using FluentNHibernate.Mapping;

public class ProductMap : ClassMap<Product>
{
    public ProductMap()
    {
        Table("Products");
        Id(x => x.Id);
        Map(x => x.Name);
        Map(x => x.Price);
    }
}

以上代码定义了一个名为 Product 的实体类的映射，指定了其对应的数据表名为 Products，并且配置了 Id、Name 和 Price 等属性的映射关系。

FluentNHibernate 官方文档

4.3.2 自动映射

FluentNHibernate 还提供了自动映射的功能，可以根据约定快速地建立对象到数据库表的映射，以下是一个简单的自动映射示例：

csharp 复制代码

var sessionFactory = Fluently.Configure()
    .Database(SQLiteConfiguration.Standard.InMemory)
    .Mappings(m =>
        m.AutoMappings.Add(
            AutoMap.AssemblyOf<Product>()
                .Where(type => type.Namespace == "MyNamespace")))
    .BuildSessionFactory();

上述代码使用了 SQLite 作为数据库，并且配置了自动映射，指定了需要映射的实体类所在的命名空间为 MyNamespace。

FluentNHibernate 自动映射官方文档

5. LLBLGen Pro：一个商业级ORM框架

LLBLGen Pro 是一个商业级 ORM（对象关系映射）框架，它提供了强大的数据访问功能和高效的实体模型设计工具。在本节中，我们将介绍LLBLGen Pro的安装与配置方法，以及其核心功能和使用场景。

5.1 简介

5.1.1 核心功能

LLBLGen Pro 提供了以下核心功能：

高性能的数据访问
灵活的实体模型设计工具
强大的查询构建和自定义查询功能
对多种数据库平台的全面支持
可扩展的架构和定制化能力

5.1.2 使用场景

LLBLGen Pro 适用于需要处理复杂数据结构和大型数据库的企业级应用程序开发。其强大的实体模型设计和高性能的数据访问能力使其特别适合于大规模数据驱动型应用的开发和维护。

5.2 安装与配置

5.2.1 安装指导

首先，您需要到 LLBLGen Pro 官方网站下载安装程序。安装完成后，您可以按照安装向导的步骤进行配置，并激活许可证以开始使用LLBLGen Pro。

5.2.2 基本配置

安装完成后，您可以根据项目需求设置连接字符串和其他基本配置信息。LLBLGen Pro 提供了直观且易于理解的配置界面，使得基本配置变得简单快捷。

5.3 API 概览

5.3.1 实体模型设计

LLBLGen Pro 提供了一套强大的实体模型设计工具，允许开发者通过直观的界面来定义和管理实体之间的关系，属性和约束。下面是一个简单的实体模型设计示例：

csharp 复制代码

using SD.LLBLGen.Pro.ORMSupportClasses;

// Define the entity
public class CustomerEntity : EntityBase
{
    public string CustomerId { get; set; }
    public string ContactName { get; set; }
    // Other properties...
}

5.3.2 查询构建

LLBLGen Pro 提供了灵活而强大的查询构建功能，使得开发者可以轻松地构建复杂的数据库查询。以下是一个基本的查询构建示例：

csharp 复制代码

using SD.LLBLGen.Pro.QuerySpec;
using MyProject.DatabaseSpecific;

// Build a query
var qf = new QueryFactory();
var customerQuery = new EntityCollection<CustomerEntity>(qf.Customer);

// Add conditions
customerQuery.Where(CustomerFields.Country.Equal("USA"));

// Execute the query
var results = new DataAccessAdapter().FetchQuery(customerQuery);

以上便是LLBLGen Pro 的简要概述。如果您对LLBLGen Pro 感兴趣，可以访问官方网站获取更多详细信息和文档。

6. PetaPoco：一个轻量级的微ORM库

6.1 简介

PetaPoco 是一个轻量级的微ORM（对象关系映射）库，旨在简化数据库访问和操作。它使用简单、轻巧，性能卓越，非常适合快速开发和小型项目。

6.1.1 核心功能

PetaPoco 提供了简洁易用的 API 来执行 CRUD 操作，支持批量操作以及灵活的配置选项。它还具有自动映射数据库表到 C# 对象的能力，减少了手动编写 SQL 查询语句和对象映射代码的工作量。

6.1.2 使用场景

PetaPoco 适用于小型项目或需要快速开发的场景，尤其是对于那些不需要过多复杂 ORM 功能、希望保持代码精简的开发者来说，是一个不错的选择。

6.2 安装与配置

6.2.1 安装指南

你可以通过 NuGet 包管理器来安装 PetaPoco，也可以直接从官方 GitHub 仓库中获取源码进行构建。以下是通过 NuGet 安装 PetaPoco 的方法：

csharp 复制代码

Install-Package PetaPoco

更多安装信息，请参考 PetaPoco 官方文档

6.2.2 基本设置

安装完成后，在使用 PetaPoco 之前，需要进行基本的配置，包括指定数据库连接字符串等。下面是一个简单的示例：

csharp 复制代码

Database db = new Database("ConnectionStringName");

6.3 API 概览

6.3.1 CRUD操作

PetaPoco 提供了一套简洁明了的 API 用于执行 CRUD 操作。以下是一个简单的示例，展示了如何使用 PetaPoco 进行数据查询和插入操作：

csharp 复制代码

// 查询
var user = db.Single<User>("SELECT * FROM Users WHERE UserId = @0", userId);

// 插入
var newUser = new User { Name = "John", Age = 25 };
db.Insert(newUser);

6.3.2 批量操作

除了基本的 CRUD 操作外，PetaPoco 还提供了便捷的批量操作方法，例如批量插入、批量更新等。以下是一个批量插入的示例：

csharp 复制代码

List<User> users = new List<User>
{
    new User { Name = "Alice", Age = 30 },
    new User { Name = "Bob", Age = 28 }
};
db.InsertBulk(users);

更多 API 和示例代码，请参考 PetaPoco GitHub 仓库

通过以上介绍，相信你已经对 PetaPoco 有了初步的了解，如果想要深入学习和了解更多细节，欢迎访问官方文档和社区。 PetaPoco 的简洁性和高效性使其成为众多开发者喜爱的微ORM库之一。

总结

通过本文的阅读，读者可以获得对多个 .NET ORM 框架的全面了解。NHibernate 是一个功能丰富的 ORM 框架，适用于复杂的领域模型；Entity Framework Core 则是一个轻量级、易扩展的 ORM 框架，适合新项目和小型团队；Dapper 则以其高性能和轻量级著称，适用于需要追求极致性能的场景；FluentNHibernate 和 PetaPoco 则分别提供了针对 NHibernate 和微ORM 的增强功能；而商业级的 LLBLGen Pro 在企业级应用中有其独特的优势。不同的项目需要根据自身特点选用合适的 ORM 框架，综合考量性能、功能和易用性等因素来做出选择。