Sparkdo.Specifications 1.0.2

There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Sparkdo.Specifications --version 1.0.2
                    
NuGet\Install-Package Sparkdo.Specifications -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.Specifications" Version="1.0.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.Specifications" Version="1.0.2" />
                    
Directory.Packages.props
<PackageReference Include="Sparkdo.Specifications" />
                    
Project file
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.Specifications --version 1.0.2
                    
#r "nuget: Sparkdo.Specifications, 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.Specifications@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.Specifications&version=1.0.2
                    
Install as a Cake Addin
#tool nuget:?package=Sparkdo.Specifications&version=1.0.2
                    
Install as a Cake Tool

Sparkdo Specifications

Sparkdo Specifications 是一个实现了规格模式(Specification Pattern)的 .NET 类库。该库提供了一种灵活且可组合的方式来定义业务规则和查询条件。

功能特性

  • 完整的规格模式实现:包括基础规格、组合规格和各种逻辑操作
  • LINQ 表达式支持:所有规格都可以转换为 LINQ 表达式,便于与 Entity Framework 等 ORM 集成
  • 流畅的 API:通过扩展方法提供链式调用语法
  • 高性能:支持表达式组合和参数重绑定,避免常见的 Entity Framework 性能问题

核心组件

基础接口和类

  • ISpecification<T>:规格的基础接口
  • Specification<T>:规格的抽象基类
  • ExpressionSpecification<T>:从 LINQ 表达式创建的规格
  • AnySpecification<T>:始终返回 true 的规格
  • NoneSpecification<T>:始终返回 false 的规格

组合规格

  • AndSpecification<T>:AND 组合规格
  • OrSpecification<T>:OR 组合规格
  • NotSpecification<T>:NOT 规格(反转)
  • AndNotSpecification<T>:AND NOT 组合规格

辅助类

  • SpecificationBuilder:创建规格的便捷方法
  • SpecificationExtensions:规格的扩展方法
  • ExpressionFuncExtender:表达式扩展方法

使用示例

基础用法

// 创建一个简单的规格
var spec = new ExpressionSpecification<Person>(p => p.Age >= 18);

// 检查对象是否满足规格
bool isSatisfied = spec.IsSatisfiedBy(person);

组合规格

// 创建多个规格
var ageSpec = new ExpressionSpecification<Person>(p => p.Age >= 18);
var nameSpec = new ExpressionSpecification<Person>(p => p.Name.StartsWith("A"));

// 组合规格
var combinedSpec = ageSpec.And(nameSpec);

使用 SpecificationBuilder

// 使用便捷方法创建规格
var spec = SpecificationBuilder.PropertyEquals<Person, int>(p => p.Age, 25);

转换为 LINQ 表达式

// 将规格转换为 LINQ 表达式,用于 Entity Framework 查询
var expression = spec.ToExpression();
var adults = context.People.Where(expression);

扩展方法

该库提供了丰富的扩展方法,支持链式调用:

  • And():AND 组合
  • Or():OR 组合
  • AndNot():AND NOT 组合
  • Not():NOT 操作(反转)
Product 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.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Sparkdo.Specifications:

Package Downloads
Sparkdo.Ddd.Domain

Sparkdo DDD 领域模型库,提供领域驱动设计的核心组件实现

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.3-preview.1 50 5/17/2026
1.0.2 293 4/27/2026
1.0.2-preview.5 81 4/15/2026
1.0.2-preview.4 98 2/8/2026
1.0.2-preview.3 103 2/1/2026
1.0.2-preview.2 110 1/31/2026
1.0.2-preview.1 187 12/4/2025
1.0.1 808 11/27/2025
1.0.0 763 11/25/2025
1.0.0-preview.5 139 10/24/2025