Sparkdo.Data
1.0.2
dotnet add package Sparkdo.Data --version 1.0.2
NuGet\Install-Package Sparkdo.Data -Version 1.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Sparkdo.Data" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.Data" Version="1.0.2" />
<PackageReference Include="Sparkdo.Data" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Sparkdo.Data --version 1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.Data, 1.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Sparkdo.Data@1.0.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Sparkdo.Data&version=1.0.2
#tool nuget:?package=Sparkdo.Data&version=1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Sparkdo.Data
Sparkdo 数据库连接管理库,提供数据库连接字符串解析、数据过滤等功能。
功能特性
- 数据库连接字符串管理
- 多数据库支持
- 数据过滤器(软删除、多租户等)
- 数据种子(Data Seeding)
- 连接字符串解析器
- 数据库迁移支持
安装
<PackageReference Include="Sparkdo.Data" Version="x.x.x" />
核心组件
SparkdoDataModule
数据模块,负责注册数据相关的服务:
IDataFilter: 数据过滤器接口IConnectionStringResolver: 连接字符串解析器接口IDataSeeder: 数据种子接口
SparkdoDbConnectionOptions
数据库连接配置选项,支持:
- 多数据库连接字符串配置
- 数据库映射配置
- 连接字符串获取与解析
DefaultDataFilter
默认数据过滤器实现,提供:
- 软删除过滤
- 多租户数据隔离
- 可扩展的数据过滤机制
DefaultConnectionStringResolver
默认连接字符串解析器,支持:
- 基于名称的连接字符串查找
- 数据库映射回退机制
- 默认连接字符串回退
DefaultDataSeeder
默认数据种子实现,用于:
- 初始化数据库数据
- 执行数据种子贡献者
- 支持增量数据种子
扩展性
该库提供了完整的数据基础设施,可以通过以下方式扩展:
- 实现自定义的
IDataFilter来添加特定的数据过滤逻辑 - 实现自定义的
IConnectionStringResolver来添加特定的连接字符串解析逻辑 - 实现自定义的
IDataSeedContributor来添加特定的数据种子逻辑 - 通过
SparkdoDbConnectionOptions配置数据库连接行为
代码结构说明
本项目包含以下主要组件:
配置选项
SparkdoDbConnectionOptions: 数据库连接配置选项SparkdoDataSeedOptions: 数据种子配置选项SparkdoDataFilterOptions: 数据过滤器配置选项
数据过滤器
IDataFilter: 数据过滤器接口DefaultDataFilter: 默认数据过滤器实现DataFilterState: 数据过滤状态
连接字符串管理
IConnectionStringResolver: 连接字符串解析器接口DefaultConnectionStringResolver: 默认连接字符串解析器实现ConnectionStringNameAttribute: 连接字符串名称特性
数据种子
IDataSeeder: 数据种子接口DefaultDataSeeder: 默认数据种子实现IDataSeedContributor: 数据种子贡献者接口
数据库信息
SparkdoDatabaseInfo: 数据库信息SparkdoDatabaseInfoDictionary: 数据库信息字典
所有公共接口和类都添加了详细的 XML 文档注释,便于开发者理解和使用。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.Extensions.Configuration (>= 10.0.5)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.5)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.5)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.5)
- Microsoft.Extensions.Configuration.Json (>= 10.0.5)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyModel (>= 10.0.5)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Localization (>= 10.0.5)
- Microsoft.Extensions.Logging (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.5)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.5)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.EventBus.Abstractions (>= 1.0.2)
- Sparkdo.Uow (>= 1.0.2)
- System.Linq.Dynamic.Core (>= 1.7.1)
NuGet packages (5)
Showing the top 5 NuGet packages that depend on Sparkdo.Data:
| Package | Downloads |
|---|---|
|
Sparkdo.MultiTenancy.Abstractions
Sparkdo 框架的多租户抽象实现。提供多租户功能的核心接口和抽象类定义。 |
|
|
Sparkdo.Ddd.Domain
Sparkdo DDD 领域模型库,提供领域驱动设计的核心组件实现 |
|
|
Sparkdo.Ddd.Application.Contracts
Sparkdo DDD应用层契约库,提供应用服务接口定义和数据传输对象(DTO)基类 |
|
|
Sparkdo.TenantManagement.Domain
Sparkdo 租户管理领域层,提供租户管理的核心业务逻辑和数据访问接口 |
|
|
Sparkdo.AuditLogging.Domain
Sparkdo 审计日志领域层,提供审计日志的核心业务逻辑和数据访问接口 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.2 | 519 | 4/27/2026 |
| 1.0.2-preview.5 | 128 | 4/15/2026 |
| 1.0.2-preview.4 | 134 | 2/8/2026 |
| 1.0.2-preview.3 | 141 | 2/1/2026 |
| 1.0.2-preview.2 | 158 | 1/31/2026 |
| 1.0.2-preview.1 | 202 | 12/4/2025 |
| 1.0.1 | 2,244 | 11/27/2025 |
| 1.0.0 | 2,157 | 11/25/2025 |
| 1.0.0-preview.5 | 140 | 10/24/2025 |