DelegateDecompiler.EntityFrameworkCore5
0.34.0
dotnet add package DelegateDecompiler.EntityFrameworkCore5 --version 0.34.0
NuGet\Install-Package DelegateDecompiler.EntityFrameworkCore5 -Version 0.34.0
<PackageReference Include="DelegateDecompiler.EntityFrameworkCore5" Version="0.34.0" />
paket add DelegateDecompiler.EntityFrameworkCore5 --version 0.34.0
#r "nuget: DelegateDecompiler.EntityFrameworkCore5, 0.34.0"
// Install DelegateDecompiler.EntityFrameworkCore5 as a Cake Addin #addin nuget:?package=DelegateDecompiler.EntityFrameworkCore5&version=0.34.0 // Install DelegateDecompiler.EntityFrameworkCore5 as a Cake Tool #tool nuget:?package=DelegateDecompiler.EntityFrameworkCore5&version=0.34.0
DelegateDecompiler
A library that is able to decompile a delegate or a method body to their lambda representation
Sponsorship
If you like the library please consider supporting my work.
Examples
Using computed properties in linq.
Asume we have a class with a computed property
class Employee
{
[Computed]
public string FullName => FirstName + " " + LastName;
public string LastName { get; set; }
public string FirstName { get; set; }
}
And you are going to query employees by their full names
var employees = (from employee in db.Employees
where employee.FullName == "Test User"
select employee).Decompile().ToList();
When you call .Decompile
method it decompiles your computed properties to their underlying representation and the query will become simmilar to the following query
var employees = (from employee in db.Employees
where (employee.FirstName + " " + employee.LastName) == "Test User"
select employee).ToList();
If your class doesn't have a [Computed] attribute, you can use the .Computed()
extension method..
var employees = (from employee in db.Employees
where employee.FullName.Computed() == "Test User"
select employee).ToList();
Also, you can call methods that return a single item (Any, Count, First, Single, etc) as well as other methods in identical way like this:
bool exists = db.Employees.Decompile().Any(employee => employee.FullName == "Test User");
Again, the FullName
property will be decompiled:
bool exists = db.Employees.Any(employee => (employee.FirstName + " " + employee.LastName) == "Test User");
Limitations
Not every compiled code can be represented as a lambda expression. Some cases are explicitly not supported, other can break and produce unexpected results.
Some of the known cases listed below
Loops
Loops often cannot be represented as an expression tree.
So, the following imperative code would probably throw a StackOverflowException
:
var total = 0;
foreach (var item in this.Items) { total += item.TotalPrice; }
return total;
Instead, write it as a declarative Linq expression, which would be supported.
return this.Items.Sum(i => i.TotalPrice);
Recursion and self-referencing
Recursion and self-referencing of computed properties cannot be represented as an Expression tree,
and would probably throw StackOverflowException
similarly to loops.
Using with EntityFramework and other ORMs
If you are using ORM specific features, like EF's Include
, AsNoTracking
or NH's Fetch
then Decompile
method should be called after all ORM specific methods, otherwise it may not work. Ideally use Decompile
extension method just before materialization methods such as ToList
, ToArray
, First
, FirstOrDefault
, Count
, Any
, and etc.
Async Support with EntityFramework 6
The DelegateDecompiler.EntityFramework package provides DecompileAsync
extension method which adds support for EF's Async operations.
Async Support with EntityFramework Core 5.0 and later
The DelegateDecompiler.EntityFrameworkCore5 package provides DecompileAsync
extension method which adds support for EF's Async operations.
Automatic decompilation
You can configure DelegateDecompiler to automatically decompile all EF Core queries:
public class YourDbContext : DbContext
{
protected override void OnConfiguring(DbContextOptionsBuilder options) {
options.AddDelegateDecompiler();
// Other configuration
}
}
With this approach you would not need to call Decompile
or DecompileAsync
methods on queries.
Installation
Available on NuGet
- Install-Package DelegateDecompiler
- Install-Package DelegateDecompiler.EntityFramework
- Install-Package DelegateDecompiler.EntityFrameworkCore5
License
MIT license - http://opensource.org/licenses/mit
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. 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. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- DelegateDecompiler (>= 0.34.0)
- Microsoft.EntityFrameworkCore (>= 5.0.0)
NuGet packages (7)
Showing the top 5 NuGet packages that depend on DelegateDecompiler.EntityFrameworkCore5:
Package | Downloads |
---|---|
OneBeyond.Studio.DataAccess.EFCore
Package Description |
|
makeITeasy.AppFramework.Infrastructure
Infrastructure module for makeITeasy.Appframework |
|
TorqIT.Tools.FilterParams
Infinite, generic and type safe filter parameters for APIs |
|
TorqIT.Tools.PagedResults
Generic and type safe paging for APIs |
|
makeITeasy.AppFramework.Infrastructure.EF7
Infrastructure module for makeITeasy.Appframework for Entity Framework 7 |
GitHub repositories (2)
Showing the top 2 popular GitHub repositories that depend on DelegateDecompiler.EntityFrameworkCore5:
Repository | Stars |
---|---|
borisdj/EFCore.BulkExtensions
Entity Framework EF Core efcore Bulk Batch Extensions with BulkCopy in .Net for Insert Update Delete Read (CRUD), Truncate and SaveChanges operations on SQL Server, PostgreSQL, MySQL, SQLite
|
|
jbogard/ContosoUniversityDotNetCore-Pages
With Razor Pages
|