👁 Image
Dapper.FastCrud 3.3.2

You hate verbatim SQL queries with zero type safety for your code but you love the speed? Dapper.FastCrud is a fast orm built around essential features of the C# 6 / VB 14 that have finally raised the simplicity of raw SQL constructs to acceptable maintenance levels. These features leave no chance to mistypings or problems arising from db entity refactorings.

What to expect when working with Dapper.FastCrud in the DAL?

Type safety, clean code, less prone to errors, more peace of mind, while still being close to the metal. Here's a sample for 3.x:

 var queryParams = new 
 {
 FirstName = "John",
 Street = "Creek Street"
 };

 var persons = dbConnection.Find<Person>(statement => statement
 .WithAlias("person")
 .Include<Address>(join => join
 .InnerJoin()
 .WithAlias("address"))
 .Where($@"
 {nameof(Person.FirstName):of person} = {nameof(queryParams.FirstName):P} 
 AND {nameof(Address.Street):of address} = {nameof(queryParams.Street):P}") 
 .OrderBy($"{nameof(Person.LastName):of person} DESC") 
 .Skip(10) 
 .Top(20) 
 .WithParameters(queryParams);

Features:

• Support for LocalDb, Ms Sql Server, MySql, SqLite, PostgreSql and SAP/Sybase SQL Anywhere.
• Entities having composite primary keys are supported, however note that the CRUD operations only support UNIQUE primary keys.
• Multiple entity mappings are supported, useful for partial queries in large denormalized tables and data migrations between different database types.
• All the CRUD methods accept a transaction, a command timeout, and a custom entity mapping.
• Fast pre-computed entity queries for simple CRUD operations.
• Compatible with component model data annotations.
• Opt-in relationships. As of 3.0, self referenced entities and multiple joins to the same target are also supported via aliases.
• A set of "formattables" are also included, which can be used even if you don't need the CRUD features of this library but you want to take advantage of the DB mappings.
• A generic T4 template for C# is also provided for convenience in the NuGet package Dapper.FastCrud.ModelGenerator.
• The following mapping styles are supported:
  • Code first, using model data annotations (preferred)
  • Database first (limited to SQL Server/LocalDb)
  • Fluent registration for POCO objects
  • Semi-POCO using metadata objects

Release Notes

3.3

• Fixed an issue where the SQL formatter was not generating proper SQL when schemas were used.
• Fixed an issue where calling OrmConfiguration.ClearEntityRegistrations was not enough to clear the state between switching dialects via OrmConfiguration.DefaultDialect.
• Schema tests added for the SQL formatter.
• Tests added to cover schemas for the MsSql, PostgreSql and SQLAnywhere dialects.

3.2

• Added support for DateOnly and TimeOnly data types, introduced in .NET6, however provider support isn't all that great across database flavors. Please check this discussion thread for more info.
• Dependencies, tests and benchmarks updated.

3.1

• Added support for SQL Anywhere
• Added support for 'rowversion' type columns for the SQL Server dialect.
• Dependencies, tests and benchmarks updated.

3.0

• Added support for .NET Standard 2.1
• Extended support for the MetadataType attribute in .NET Standard 2.1
• Bulk update can now be used with parameters.
• Format specifier ":P" added for SQL parameters.
• Format specifiers extended to support resolution via aliases in JOINs (e.g. "nameof(prop):of alias").
• Methods adjusted for nullable support.
• [Breaking change] Clean separation for the formatter and the sql builder. As a result, the access to the formatter got moved out of the ISqlBuilder and into the Sql static class.
• Extended the functionality of the Sql "formattables", exposed via the Sql static class, to allow for easy access to both the raw resolved names and their SQL ready counterparts.
• Relationships have been reworked:
  • [Breaking change] The fluent mapping setup has changed for setting up relationships.
  • The limit of 7 entities in a JOIN was removed.
  • The main entity and the JOINed entities can now be aliased. It is now recommended to do so when working with multiple entities in a statement for easy targeting in the WHERE clause.
  • JOIN support has been extended to the GET and COUNT methods.
  • SQL statements no longer require the presence of a relationship preset in the mappings. You can join with whatever you want, using whatever navigation properties you want (or none) and with any ON clause you desire.
  • Added support for self referenced entities (via InverseProperty attribute / fluent mappings / directly in the query).
  • Added support for one-to-one relationships (via InverseProperty attribute / fluent mappings / directly in the query).
  • Added support for multiple references to the same target (via InverseProperty attribute / fluent mappings / directly in the query).