LogicBuilder.EntityFrameworkCore
8.0.2
Prefix Reserved
dotnet add package LogicBuilder.EntityFrameworkCore --version 8.0.2
NuGet\Install-Package LogicBuilder.EntityFrameworkCore -Version 8.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="LogicBuilder.EntityFrameworkCore" Version="8.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="LogicBuilder.EntityFrameworkCore" Version="8.0.2" />
<PackageReference Include="LogicBuilder.EntityFrameworkCore" />
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 LogicBuilder.EntityFrameworkCore --version 8.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: LogicBuilder.EntityFrameworkCore, 8.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 LogicBuilder.EntityFrameworkCore@8.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=LogicBuilder.EntityFrameworkCore&version=8.0.2
#tool nuget:?package=LogicBuilder.EntityFrameworkCore&version=8.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
LogicBuilder.EntityFrameworkCore
A repository pattern library for Entity Framework Core that provides seamless mapping between business models and data entities, with advanced expression translation capabilities.
Features
- Two-Way Object Mapping: Automatically maps business model objects to and from data entities using AutoMapper
- Expression Translation: Translates LINQ query expressions from business model to data model, enabling queries to be written against your business layer
- Repository Pattern: Implements a clean repository pattern with
IContextRepositoryandContextRepositoryBase - Store Layer: Provides
IStoreandStoreBasefor direct DbContext operations - Advanced Querying: Supports complex operations including:
- Filtering with
Expression<Func<TModel, bool>> - Sorting and pagination
- Grouping and aggregations
- Select/expand operations
- Include navigation properties
- Filtering with
- CRUD Operations: Full support for Create, Read, Update, Delete operations
- Graph Operations: Save entire object graphs with
SaveGraphAsyncandSaveGraphsAsync - Change Tracking: Methods to manage EF Core change tracker (
AddChanges,ClearChangeTracker,DetachAllEntries) - Batch Operations: Support for batch saves and deletes
Installation
dotnet add package LogicBuilder.EntityFrameworkCore
Usage
//Create a context
public class SchoolContext : DbContext
{
public SchoolContext(DbContextOptions<SchoolContext> options) : base(options)
{
}
}
//Create Store
public interface ISchoolStore : IStore
{
}
public class SchoolStore : StoreBase, ISchoolStore
{
public SchoolStore(SchoolContext context)
: base(context)
{
}
}
//Create Repository
public interface ISchoolRepository : IContextRepository
{
}
public class SchoolRepository : ContextRepositoryBase, ISchoolRepository
{
public SchoolRepository(ISchoolStore store, IMapper mapper) : base(store, mapper)
{
}
}
//Register Services including AutoMapper profiles.
IServiceProvider serviceProvider = new ServiceCollection()
.AddDbContext<SchoolContext>
(
options =>
{
options.UseInMemoryDatabase("ContosoUniversity");
options.UseInternalServiceProvider(new ServiceCollection().AddEntityFrameworkInMemoryDatabase().BuildServiceProvider());
}
)
.AddTransient<ISchoolStore, SchoolStore>()
.AddTransient<ISchoolRepository, SchoolRepository>()
.AddSingleton<AutoMapper.IConfigurationProvider>(new MapperConfiguration(cfg => cfg.AddProfiles(typeof(SchoolProfile).GetTypeInfo().Assembly)))
.AddTransient<IMapper>(sp => new Mapper(sp.GetRequiredService<AutoMapper.IConfigurationProvider>(), sp.GetService))
.BuildServiceProvider();
//Call the repository (inside an async method)
ISchoolRepository repository = serviceProvider.GetRequiredService<ISchoolRepository>();
ICollection<StudentModel> list = await repository.GetAsync<StudentModel, Student>();
Key Interfaces
IContextRepository
Provides methods for:
GetAsync<TModel, TData>- Retrieve entities with optional filtering and queryingCountAsync<TModel, TData>- Count entities matching a filterQueryAsync<TModel, TData, TModelReturn, TDataReturn>- Execute complex queries with expression translationSaveAsync<TModel, TData>- Save single or multiple entitiesSaveGraphAsync<TModel, TData>- Save entity graphsDeleteAsync<TModel, TData>- Delete entities by filterAddChanges<TModel, TData>- Stage changes without savingSaveChangesAsync- Persist all staged changesClearChangeTracker/DetachAllEntries- Manage change tracking
Requirements
- .NET 8.0 or higher
- Entity Framework Core
- AutoMapper with expression mapping support
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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
- AutoMapper.Extensions.ExpressionMapping (>= 11.0.0 && < 12.0.0)
- LogicBuilder.Data (>= 8.0.1)
- LogicBuilder.Domain (>= 8.0.1)
- LogicBuilder.Expressions.Utils (>= 8.0.2)
- LogicBuilder.Forms.Parameters (>= 2.1.1)
- Microsoft.EntityFrameworkCore (>= 10.0.9)
-
net8.0
- AutoMapper.Extensions.ExpressionMapping (>= 11.0.0 && < 12.0.0)
- LogicBuilder.Data (>= 8.0.1)
- LogicBuilder.Domain (>= 8.0.1)
- LogicBuilder.Expressions.Utils (>= 8.0.2)
- LogicBuilder.Forms.Parameters (>= 2.1.1)
- Microsoft.EntityFrameworkCore (>= 8.0.22)
-
net9.0
- AutoMapper.Extensions.ExpressionMapping (>= 11.0.0 && < 12.0.0)
- LogicBuilder.Data (>= 8.0.1)
- LogicBuilder.Domain (>= 8.0.1)
- LogicBuilder.Expressions.Utils (>= 8.0.2)
- LogicBuilder.Forms.Parameters (>= 2.1.1)
- Microsoft.EntityFrameworkCore (>= 9.0.11)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Adding reusable mapping profiles for UI parameter classes.