Kck.Persistence.EntityFramework
5.0.0
dotnet add package Kck.Persistence.EntityFramework --version 5.0.0
NuGet\Install-Package Kck.Persistence.EntityFramework -Version 5.0.0
<PackageReference Include="Kck.Persistence.EntityFramework" Version="5.0.0" />
<PackageVersion Include="Kck.Persistence.EntityFramework" Version="5.0.0" />
<PackageReference Include="Kck.Persistence.EntityFramework" />
paket add Kck.Persistence.EntityFramework --version 5.0.0
#r "nuget: Kck.Persistence.EntityFramework, 5.0.0"
#:package Kck.Persistence.EntityFramework@5.0.0
#addin nuget:?package=Kck.Persistence.EntityFramework&version=5.0.0
#tool nuget:?package=Kck.Persistence.EntityFramework&version=5.0.0
Kck.Persistence.EntityFramework
Entity Framework Core integration for Kck applications — registers IUnitOfWork (repositories via IUnitOfWork.Repository<T, TId>()), audit / soft-delete and domain event interceptors, and dynamic query extensions.
New to Kck? Your first Kck API in five minutes creates a working API with this package: dotnet new install Kck.Templates, then dotnet new kck-webapi.
Installation
dotnet add package Kck.Persistence.EntityFramework
Quick Start
// Program.cs
using Kck.Persistence.EntityFramework.Extensions;
builder.Services.AddKckPersistence(p => p
.UseEntityFramework<AppDbContext>(options =>
options.UseSqlServer(builder.Configuration.GetConnectionString("Default")!))
.AddAuditInterceptor()); // CreatedDate / ModifiedDate, DbContext.Remove -> soft delete
// Use a repository through the unit of work
public class OrderService(IUnitOfWork uow)
{
public async Task<Order> CreateAsync(Order order, CancellationToken ct)
{
await uow.Repository<Order, Guid>().AddAsync(order, ct);
await uow.SaveChangesAsync(cancellationToken: ct);
return order;
}
}
Configuration
| Method | Description |
|---|---|
UseEntityFramework<TContext>(options) |
Registers the DbContext (AddDbContext) and IUnitOfWork |
AddAuditInterceptor() |
Audit fields and soft delete for IAuditable / ISoftDeletable entities; register an IAuditUserProvider to also set CreatedBy / ModifiedBy / DeletedBy |
AddDomainEventHandlers(assemblies) |
Registers every IDomainEventHandler<TEvent> in the assemblies and dispatches domain events to them after SaveChanges / commit (4.6.0+) |
AddDomainEventDispatch<TDispatcher>() |
Dispatches aggregate domain events after SaveChanges / commit through your own IDomainEventDispatcher |
Diagnostics
The package includes analyzers: KCK1001
warns about a transaction committed directly in a project with domain events (commit through IUnitOfWork so the
events are dispatched), and KCK1002
suggests SaveChangesAsync over SaveChanges.
Resources
| 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. |
-
net10.0
- Kck.Core.Abstractions (>= 5.0.0)
- Kck.Persistence.Abstractions (>= 5.0.0)
- Microsoft.EntityFrameworkCore (>= 10.0.14)
- Microsoft.EntityFrameworkCore.Relational (>= 10.0.14)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 10.0.14)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Kck.Persistence.EntityFramework:
| Package | Downloads |
|---|---|
|
Kck.Bundle.WebApi
Opinionated ASP.NET Core WebAPI starter pack. Registers Serilog, in-memory caching, the JWT token service, Argon2 hashing, InMemory event bus, health checks, rate limiting, security headers, CORS, and global exception handling in a single AddKckWebApiDefaults() call. |
GitHub repositories
This package is not used by any popular GitHub repositories.