DelegateDecompiler 0.34.0
dotnet add package DelegateDecompiler --version 0.34.0
NuGet\Install-Package DelegateDecompiler -Version 0.34.0
<PackageReference Include="DelegateDecompiler" Version="0.34.0" />
paket add DelegateDecompiler --version 0.34.0
#r "nuget: DelegateDecompiler, 0.34.0"
// Install DelegateDecompiler as a Cake Addin #addin nuget:?package=DelegateDecompiler&version=0.34.0 // Install DelegateDecompiler as a Cake Tool #tool nuget:?package=DelegateDecompiler&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 | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net40 is compatible. net403 was computed. net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.0
- Mono.Reflection (>= 2.0.0)
-
.NETFramework 4.5
- Mono.Reflection (>= 2.0.0)
-
.NETStandard 2.0
- Mono.Reflection (>= 2.0.0)
-
.NETStandard 2.1
- Mono.Reflection (>= 2.0.0)
NuGet packages (16)
Showing the top 5 NuGet packages that depend on DelegateDecompiler:
Package | Downloads |
---|---|
DelegateDecompiler.EntityFramework
A library which is able to decompile a delegate or a method body to its lambda representation |
|
DelegateDecompiler.EntityFrameworkCore5
A library which is able to decompile a delegate or a method body to its lambda representation |
|
DelegateDecompiler.EntityFrameworkCore
A library which is able to decompile a delegate or a method body to its lambda representation |
|
TouchConvert.Tenant.Api.V1.Dtos
Data transfer objects for TouchConvert version one APIs. |
|
TouchConvert.Tenant.Api.V2.Dtos
Data transfer objects for TouchConvert version two APIs. |
GitHub repositories (4)
Showing the top 4 popular GitHub repositories that depend on DelegateDecompiler:
Repository | Stars |
---|---|
DataDog/dd-trace-dotnet
.NET Client Library for Datadog APM
|
|
whywhy898/DDit-Rapid-Development-Framework
帮助企业快速开发的.net项目框架 Help companies develop the.net project framework
|
|
JonPSmith/GenericServices
GenericServices helps with building a service/application layer in a .NET based application using EF6.x
|
|
AndreyAkinshin/knockout-mvc
Power of Knockout.js for ASP.NET MVC
|
Version | Downloads | Last updated |
---|---|---|
0.34.0 | 38,667 | 5/27/2024 |
0.33.1 | 6,705 | 5/3/2024 |
0.33.0 | 199 | 5/3/2024 |
0.32.0 | 1,045,265 | 10/20/2022 |
0.31.0 | 5,538 | 10/17/2022 |
0.30.0 | 568,738 | 12/14/2021 |
0.29.1 | 431,423 | 2/4/2021 |
0.29.0 | 1,965 | 2/4/2021 |
0.28.3 | 69,305 | 1/9/2021 |
0.28.2 | 39,682 | 11/12/2020 |
0.28.1 | 1,957 | 11/12/2020 |
0.28.0 | 879,632 | 10/31/2019 |
0.27.0 | 52,101 | 9/30/2019 |
0.26.1 | 100,596 | 8/8/2019 |
0.25.0 | 350,020 | 1/2/2019 |
0.24.0 | 570,756 | 4/28/2018 |
0.23.0 | 975,636 | 3/13/2017 |
0.22.0 | 42,919 | 1/10/2017 |
0.21.0 | 303,766 | 12/25/2016 |
0.20.0 | 263,264 | 10/5/2016 |
0.19.0 | 13,133 | 9/7/2016 |
0.18.1 | 1,313,491 | 1/4/2016 |
0.18.0 | 14,103 | 12/29/2015 |
0.17.0 | 192,127 | 7/30/2015 |
0.16.0 | 57,360 | 5/25/2015 |
0.15.1 | 13,082 | 4/16/2015 |
0.15.0 | 9,066 | 1/14/2015 |
0.14.1 | 2,544 | 1/13/2015 |
0.13.1 | 2,864 | 1/12/2015 |
0.13.0 | 15,566 | 12/14/2014 |
0.12.1 | 2,803 | 12/12/2014 |
0.11.1 | 3,646 | 11/6/2014 |
0.10.1 | 3,278 | 10/16/2014 |
0.10.0 | 2,026 | 10/15/2014 |
0.9.1 | 98,668 | 5/28/2014 |
0.9.0 | 4,916 | 5/7/2014 |
0.8.3 | 13,885 | 8/24/2013 |
0.8.2 | 2,821 | 7/14/2013 |
0.8.1 | 24,497 | 5/16/2013 |
0.8.0 | 2,487 | 4/12/2013 |
0.7.2 | 2,654 | 3/12/2013 |
0.6.0 | 59,785 | 10/24/2012 |