| Package | NuGet Stable | NuGet Pre-release | Downloads |
|---|---|---|---|
| Sean.Core.DbRepository |  |  |  |
| Sean.Core.DbRepository.Dapper |  |  |  |
ORM framework, support databases: MySQL, MariaDB, TiDB, OceanBase, SQL Server, Oracle, SQLite, DuckDB, MS Access, Firebird, PostgreSql, OpenGauss, HighgoDB(瀚高), IvorySQL, QuestDB, DB2, Informix, ClickHouse, 达梦, KingbaseES(人大金仓), 神通, 虚谷, ...
License
—
Deps
8
Install Size
—
Vulns
✓ 0
Published
Aug 23, 2025
$ dotnet add package Sean.Core.DbRepository.Dapper
ORM框架，支持数据库：MySQL、MariaDB、TiDB、OceanBase、SQL Server、Oracle、SQLite、DuckDB、MS Access、Firebird、PostgreSql、OpenGauss、HighgoDB(瀚高)、IvorySQL、QuestDB、DB2、Informix、ClickHouse、Dameng(达梦)、KingbaseES(人大金仓)、ShenTong(神通)、Xugu(虚谷)
DbFirst、CodeFirstExpression表达式树解析：whereExpression、fieldExpression| Class |
|---|
| Namespace |
|---|
| Description |
|---|
DbFactory | Sean.Core.DbRepository | 数据库工厂 |
SqlFactory | Sean.Core.DbRepository | SQL创建工厂（CRUD） |
BaseRepository<br>BaseRepository<TEntity> | Sean.Core.DbRepository | 基于DbFactory实现 |
DapperBaseRepository<br>DapperBaseRepository<TEntity> | Sean.Core.DbRepository.Dapper | 基于DbFactory+Dapper实现 |
| Package | NuGet Stable | NuGet Pre-release | Downloads |
|---|---|---|---|
| Sean.Core.DbRepository | | | |
| Sean.Core.DbRepository.Dapper | | | |
CRUD Test:
TestRepository.csDbFirst:
CodeGeneratorFactoryCodeFirst:
SqlGeneratorFactory
| Database | CRUD Test | DbFirst | CodeFirst | Description |
|---|---|---|---|---|
MySQL | ✅ | ✅ | ✅ | |
MariaDB | ✅ | ✅ | ✅ | |
TiDB | ✅ | ✅ | ✅ | |
OceanBase | ✅ | ✅ | ✅ | |
SQL Server | ✅ | ✅ | ✅ | |
Oracle | ✅ | ✅ | ✅ | |
SQLite | ✅ | ✅ | ✅ | |
DuckDB | ✅ | ✅ | ✅ | |
MS Access | ✅ | ✅ | ✅ | |
Firebird | ✅ | ✅ | ✅ | |
PostgreSql | ✅ | ✅ | ✅ | |
OpenGauss | ✅ | ✅ | ✅ | |
HighgoDB | ✅ | ✅ | ✅ | 瀚高数据库 |
IvorySQL | ✅ | ✅ | ✅ | |
QuestDB | ✅ | ✅ | ||
DB2 | ✅ | ✅ | ||
Informix | ✅ | ✅ | ||
ClickHouse | ✅ | ✅ | ||
Dameng | ✅ | ✅ | 达梦 | |
KingbaseES | ✅ | ✅ | 人大金仓 | |
ShenTong | ✅ | ✅ | 神通数据库 | |
Xugu | ✅ | ✅ | 虚谷数据库 |
Dapper的Execute方法执行插入批量实体数据的本质是一条一条的插入，当数据量非常大时会很慢，可以分批把多条实体数据拼成一条脚本一次性执行（BulkInsert）。
PerformanceComparisonTest.CompareBulkInsertTimeConsumed| Operation | 50 Entities | 200 Entities | 1000 Entities | 2000 Entities | 5000 Entities |
|---|---|---|---|---|---|
Dapper.Execute | 318 ms | 1401 ms | 5875 ms | 11991 ms | 29968 ms |
BulkInsert | 15 ms | 27 ms | 84 ms | 176 ms | 471 ms |
.NET Framework:App.config、Web.config
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<connectionStrings>
<!-- 主库：如果配置了多个数据库，数据库名称后缀是以1开始的数字。 -->
<!-- Master database: If multiple databases are configured, the suffix of the database name is a number starting with 1. -->
<add name="master" connectionString="DataSource=127.0.0.1;Database=test;uid=root;pwd=12345!a" providerName="MySql.Data.MySqlClient"/>
<!-- 从库：如果配置了多个数据库，数据库名称后缀是以1开始的数字。 -->
<!-- Slave database: If multiple databases are configured, the suffix of the database name is a number starting with 1. -->
<add name="secondary1" connectionString="DataSource=127.0.0.1;Database=test;uid=root;pwd=12345!a" providerName="MySql.Data.MySqlClient"/>
<add name="secondary2" connectionString="DataSource=127.0.0.1;Database=test;uid=root;pwd=12345!a" providerName="MySql.Data.MySqlClient"/>
</connectionStrings>
<appSettings>
</appSettings>
<system.data>
<DbProviderFactories>
<remove invariant="MySql.Data.MySqlClient" />
<add name="MySQL Data Provider" invariant="MySql.Data.MySqlClient" description=".Net Framework Data Provider for MySQL" type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data"/>
</DbProviderFactories>
</system.data>
</configuration>
.NET Core:appsettings.json
ProviderName或DatabaseType的值来指定数据库类型{
"ConnectionStrings": {
// 主库：如果配置了多个数据库，数据库名称后缀是以1开始的数字。
// Master database: If multiple databases are configured, the suffix of the database name is a number starting with 1.
"master": "DataSource=127.0.0.1;Database=test;uid=root;pwd=12345!a;ProviderName=MySql.Data.MySqlClient",
// 从库：如果配置了多个数据库，数据库名称后缀是以1开始的数字。
// Slave database: If multiple databases are configured, the suffix of the database name is a number starting with 1.
"secondary1": "DataSource=127.0.0.1;Database=test;uid=root;pwd=12345!a;ProviderName=MySql.Data.MySqlClient",
"secondary2": "DataSource=127.0.0.1;Database=test;uid=root;pwd=12345!a;ProviderName=MySql.Data.MySqlClient",
"test_SqlServer": "server=127.0.0.1;database=test;uid=sa;pwd=123456!a;DatabaseType=SqlServer",
"test_Oracle": "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=127.0.0.1)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XXX)));User ID=XXX;Password=XXX;Persist Security Info=True;DatabaseType=Oracle",
"test_SQLite": "data source=.\\test.db;version=3;DatabaseType=SQLite"
}
}支持2种方式来配置数据库和数据库提供者工厂之间的映射关系：
DatabaseType.MySql.SetDbProviderMap(new DbProviderMap("MySql.Data.MySqlClient", MySqlClientFactory.Instance));// MySql
DatabaseType.SqlServer.SetDbProviderMap(new DbProviderMap("System.Data.SqlClient", SqlClientFactory.Instance));// Microsoft SQL Server
DatabaseType.Oracle.SetDbProviderMap(new DbProviderMap("Oracle.ManagedDataAccess.Client", OracleClientFactory.Instance));// Oracle
DatabaseType.SQLite.SetDbProviderMap(new DbProviderMap("System.Data.SQLite", SQLiteFactory.Instance));// SQLiteDatabaseType.MySql.SetDbProviderMap(new DbProviderMap("MySql.Data.MySqlClient", "MySql.Data.MySqlClient.MySqlClientFactory,MySql.Data"));// MySql
DatabaseType.SqlServer.SetDbProviderMap(new DbProviderMap("System.Data.SqlClient", "System.Data.SqlClient.SqlClientFactory,System.Data.SqlClient"));// Microsoft SQL Server
DatabaseType.Oracle.SetDbProviderMap(new DbProviderMap("Oracle.ManagedDataAccess.Client", "Oracle.ManagedDataAccess.Client.OracleClientFactory,Oracle.ManagedDataAccess"));// Oracle
DatabaseType.SQLite.SetDbProviderMap(new DbProviderMap("System.Data.SQLite", "System.Data.SQLite.SQLiteFactory,System.Data.SQLite"));// SQLite// 如果直接使用数据库提供者工厂，也可以不配置数据库和数据库提供者工厂之间的映射关系。代码示例：
var db = new DbFactory("Database connection string...", MySqlClientFactory.Instance);// MySql配置文件路径可以通过
DbContextConfiguration.Options.DbProviderFactoryConfigurationPath设置
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="dbProviderMap" type="Sean.Core.DbRepository.DbProviderMapSection, Sean.Core.DbRepository" />
</configSections>
<dbProviderMap>
<databases>
<!-- Supports configuring databases that implement the DbProviderFactory class. -->
<database name="MySql" providerInvariantName="MySql.Data.MySqlClient" factoryTypeAssemblyQualifiedName="MySql.Data.MySqlClient.MySqlClientFactory,MySql.Data"/>
<database name="MariaDB" providerInvariantName="MySqlConnector.MariaDB" factoryTypeAssemblyQualifiedName="MySqlConnector.MySqlConnectorFactory,MySqlConnector"/>
<database name="TiDB" providerInvariantName="TiDB" factoryTypeAssemblyQualifiedName="MySql.Data.MySqlClient.MySqlClientFactory,MySql.Data"/>
<database name="OceanBase" providerInvariantName="OceanBase" factoryTypeAssemblyQualifiedName="MySql.Data.MySqlClient.MySqlClientFactory,MySql.Data"/>
<database name="SqlServer" providerInvariantName="System.Data.SqlClient" factoryTypeAssemblyQualifiedName="System.Data.SqlClient.SqlClientFactory,System.Data"/>
<database name="Oracle" providerInvariantName="Oracle.ManagedDataAccess.Client" factoryTypeAssemblyQualifiedName="Oracle.ManagedDataAccess.Client.OracleClientFactory,Oracle.ManagedDataAccess"/>
<database name="SQLite" providerInvariantName="System.Data.SQLite" factoryTypeAssemblyQualifiedName="System.Data.SQLite.SQLiteFactory,System.Data.SQLite"/>
<database name="DuckDB" providerInvariantName="DuckDB.NET.Data" factoryTypeAssemblyQualifiedName="DuckDB.NET.Data.DuckDBClientFactory,DuckDB.NET.Data"/>
<database name="MsAccess" providerInvariantName="System.Data.OleDb" factoryTypeAssemblyQualifiedName="System.Data.OleDb.OleDbFactory,System.Data"/>
<!--<database name="MsAccess" providerInvariantName="System.Data.Odbc" factoryTypeAssemblyQualifiedName="System.Data.Odbc.OdbcFactory,System.Data"/>-->
<database name="Firebird" providerInvariantName="FirebirdSql.Data.FirebirdClient" factoryTypeAssemblyQualifiedName="FirebirdSql.Data.FirebirdClient.FirebirdClientFactory,FirebirdSql.Data.FirebirdClient"/>
<database name="PostgreSql" providerInvariantName="Npgsql" factoryTypeAssemblyQualifiedName="Npgsql.NpgsqlFactory,Npgsql"/>
<database name="OpenGauss" providerInvariantName="OpenGauss" factoryTypeAssemblyQualifiedName="OpenGauss.NET.OpenGaussFactory,OpenGauss.NET"/>
<database name="HighgoDB" providerInvariantName="HighgoDB" factoryTypeAssemblyQualifiedName="Npgsql.NpgsqlFactory,Npgsql"/>
<database name="IvorySQL" providerInvariantName="IvorySQL" factoryTypeAssemblyQualifiedName="Npgsql.NpgsqlFactory,Npgsql"/>
<database name="QuestDB" providerInvariantName="QuestDB" factoryTypeAssemblyQualifiedName="Npgsql.NpgsqlFactory,Npgsql"/>
<database name="DB2" providerInvariantName="IBM.Data.DB2" factoryTypeAssemblyQualifiedName="IBM.Data.DB2.Core.DB2Factory,IBM.Data.DB2.Core"/>
<database name="Informix" providerInvariantName="IBM.Data.Informix" factoryTypeAssemblyQualifiedName="IBM.Data.Informix.IfxFactory,IBM.Data.Informix"/>
<database name="ClickHouse" providerInvariantName="ClickHouse.Client" factoryTypeAssemblyQualifiedName="ClickHouse.Client.ADO.ClickHouseConnectionFactory,ClickHouse.Client"/>
<database name="Dameng" providerInvariantName="Dameng" factoryTypeAssemblyQualifiedName="Dm.DmClientFactory,DmProvider"/>
<database name="KingbaseES" providerInvariantName="Kdbndp" factoryTypeAssemblyQualifiedName="Kdbndp.KdbndpFactory,Kdbndp"/>
<database name="ShenTong" providerInvariantName="ShenTong" factoryTypeAssemblyQualifiedName="System.Data.OscarClient.OscarFactory,Oscar.Data.SqlClient"/>
<database name="Xugu" providerInvariantName="Xugu" factoryTypeAssemblyQualifiedName="XuguClient.XGProviderFactory,XuguClient"/>
</databases>
</dbProviderMap>
</configuration>
IBaseRepository<TEntity>
// 新增数据：
_testRepository.Add(entity);
// 批量新增数据：
_testRepository.Add(entities);
// 新增或更新数据：
_testRepository.AddOrUpdate(entity);
// 批量新增或更新数据：
_testRepository.AddOrUpdate(entities);
// 删除数据：过滤条件默认为实体的主键字段
_testRepository.Delete(entity);
// 删除数据：自定义过滤条件
_testRepository.Delete(entity => entity.UserId == 10001 && entity.Status != 0);
// 删除全部数据：
_testRepository.Delete(entity => true);
// 删除全部数据：
_testRepository.DeleteAll();
// 更新数据：更新全部字段，过滤条件默认为实体的主键字段
_testRepository.Update(entity);
// 更新数据：更新部分字段，过滤条件默认为实体的主键字段
_testRepository.Update(entity, fieldExpression: entity => new { entity.Status, entity.UpdateTime });
// 更新数据：更新全部字段，自定义过滤条件
_testRepository.Update(entity, whereExpression: entity => entity.UserId == 10001 && entity.Status != 0);
// 更新数据：更新部分字段，自定义过滤条件
_testRepository.Update(entity, fieldExpression: entity => new { entity.Status, entity.UpdateTime }, whereExpression: entity => entity.UserId == 10001 && entity.Status != 0);
// 批量更新数据：更新全部字段，过滤条件默认为实体的主键字段
_testRepository.Update(entities);
// 批量更新数据：更新部分字段，过滤条件默认为实体的主键字段
_testRepository.Update(entities, fieldExpression: entity => new { entity.Status, entity.UpdateTime });
// 数值字段递增：
_testRepository.Increment(10.0M, fieldExpression: entity => entity.AccountBalance, whereExpression: entity => entity.Id == 10001);
// 数值字段递减：
_testRepository.Decrement(10.0M, fieldExpression: entity => entity.AccountBalance, whereExpression: entity => entity.Id == 10001);
// 查询数据：分页 + 排序
int pageIndex = 1;// 当前页号（最小值为1）
int pageSize = 10;// 页大小
OrderByCondition orderBy = OrderByConditionBuilder<TestEntity>.Build(OrderByType.Asc, entity => entity.CreateTime);
orderBy.Next = OrderByConditionBuilder<TestEntity>.Build(OrderByType.Asc, entity => entity.Id);
List<TestEntity> queryResult = _testRepository.Query(entity => entity.UserId == 10001, orderBy, pageIndex, pageSize)?.ToList();
// 查询单个数据：
TestEntity getResult = _testRepository.Get(entity => entity.Id == 2);
// 统计数量：
int countResult = _testRepository.Count(entity => entity.UserId == 10001);
// 数据是否存在：
bool exists = _testRepository.Exists(entity => entity.UserId == 10001);
// 更多使用示例在单元测试中：Sean.Core.DbRepository.Test.TableRepositoryTest表达式树：
Expression<Func<TEntity, bool>> whereExpression
// 常量
entity => entity.UserId == 10001L
// 变量
entity => entity.UserId == _model.UserId
// bool
entity => entity.IsVip
// bool
entity => !entity.IsVip
// &&
entity => entity.UserId == _model.UserId && entity.AccountBalance < accountBalance
// ||
entity => entity.UserId == _model.UserId || entity.AccountBalance >= accountBalance
// StartsWith
entity => entity.UserId == _model.UserId && entity.Remark.StartsWith("测试")
// 更多使用示例在单元测试中：Sean.Core.DbRepository.Test.WhereExpressionTest表达式树：
Expression<Func<TEntity, object>> fieldExpression
// 单个字段：
entity => entity.Status
// 多个字段（匿名类型）：
entity => new { entity.Status, entity.UpdateTime }
// 更多使用示例在单元测试中：Sean.Core.DbRepository.Test.FieldExpressionTest常用实体类注解：
TableEntity
| Attribute | AttributeUsage | Namespace | Description |
|---|---|---|---|
TableAttribute | Class | System.ComponentModel.DataAnnotations.Schema | 自定义表名 |
SequenceAttribute | Property | Sean.Core.DbRepository | 指定序列号名称（生成自增Id） |
KeyAttribute | Property | System.ComponentModel.DataAnnotations | 标记为主键字段 |
DatabaseGeneratedAttribute | Property | System.ComponentModel.DataAnnotations.Schema | 设置数据库生成字段值的方式（通常和KeyAttribute一起使用） |
ColumnAttribute | Property | System.ComponentModel.DataAnnotations.Schema | 自定义字段名 |
NotMappedAttribute | Property | System.ComponentModel.DataAnnotations.Schema | 标记为为忽略字段 |
ForeignKeyAttribute | Property | System.ComponentModel.DataAnnotations.Schema | 标记为外键字段（暂不支持） |
OleDb和ODBC的区别？
OleDb是Microsoft开发的一种数据库连接技术，它是面向对象的，可以连接多种类型的数据库，包括Access、Excel、SQL Server等等。OleDb使用COM接口连接数据库，因此只能在Windows平台上使用。ODBC是一种通用的数据库连接技术，它可以连接多种类型的数据库，包括Access、Excel、SQL Server等等。ODBC使用标准的API连接数据库，因此可以在多个平台上使用，包括Windows、Linux、Unix等等。