Z.Expressions.Eval 6.2.12

dotnet add package Z.Expressions.Eval --version 6.2.12
                    
NuGet\Install-Package Z.Expressions.Eval -Version 6.2.12
                    
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="Z.Expressions.Eval" Version="6.2.12" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Z.Expressions.Eval" Version="6.2.12" />
                    
Directory.Packages.props
<PackageReference Include="Z.Expressions.Eval" />
                    
Project file
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 Z.Expressions.Eval --version 6.2.12
                    
#r "nuget: Z.Expressions.Eval, 6.2.12"
                    
#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.
#addin nuget:?package=Z.Expressions.Eval&version=6.2.12
                    
Install Z.Expressions.Eval as a Cake Addin
#tool nuget:?package=Z.Expressions.Eval&version=6.2.12
                    
Install Z.Expressions.Eval as a Cake Tool

Z.Expressions.Eval: C# Eval Expression

Z.Expressions.Eval is a robust NuGet package that enables .NET developers to evaluate, compile, and execute dynamic C# expressions. By interpreting and processing strings as executable code, this package empowers developers to craft highly adaptable and customizable applications.

It has the capability to handle an extensive range of mathematical operations, string manipulations, boolean logic, and it can even interact with .NET objects and classes.

The principal advantage of Z.Expressions.Eval lies in its ability to provide enhanced flexibility by facilitating runtime execution and manipulation of C# expressions. This feature is particularly beneficial in scenarios where business rules are subject to frequent changes or need to be configurable.

Having earned the trust and endorsement of over 5000 customers worldwide, C# Eval Expression is a highly regarded library that has become an essential tool for a wide variety of projects.

Resources:

  • Official Website: Visit for comprehensive information, updates, tutorials, and more. Learn how Z.Expressions.Eval can significantly enhance your application's capabilities.
  • Contact Us: Have a question or need assistance? Don't hesitate to reach out. We're here to help you get the most out of C# Eval Expression.
  • GitHub Issues: Encountered an issue or have a feature request? Let us know on GitHub. Your feedback helps us make C# Eval Expression even better.

Supported .NET Versions

Z.Expressions.Eval exhibits broad compatibility with a variety of .NET versions. Starting from .NET Framework 4.5 and .NET Core 2.0, it extends support to the most recent versions of .NET.

To take full advantage of the enhancements in newer .NET versions, we highly recommend upgrading to the latest package version of Z.Expressions.Eval.

Main Features

Z.Expressions.Eval provides a set of powerful features designed to simplify dynamic C# expression evaluation and execution. Here are some of the key features:

  • Eval.Execute: Allows you to evaluate and execute a string as a C# expression at runtime. This feature can handle a wide variety of mathematical operations, string manipulations, boolean logic, and even work with .NET objects and classes.
  • Eval.Compile: Offers the ability to compile a string as a C# expression at runtime, reducing the overhead of repeated evaluations. This feature is especially useful when working with expressions that need to be executed multiple times.
  • LINQ Dynamic: Provides the power to execute LINQ expressions dynamically. This feature opens up new possibilities for creating highly flexible and configurable queries.

For a more detailed explanation and examples of each operation, please refer to the official documentation page.

Getting Started

To get a feel for Z.Expressions.Eval, here is a simple example:

using Z.Expressions;

public class Program
{
    public static void Main()
    {
        var result = Eval.Execute<int>("X*Y", new { X = 10, Y = 20 });
        Console.WriteLine(result); // Outputs: 200
    }
}

In the above example, the "X*Y" string expression is evaluated dynamically at runtime with the values of X and Y provided in an anonymous object. The result is then printed to the console.

Want to explore the library further? We offer an extensive collection of online examples showcasing the various functionalities and capabilities of C# Eval Expression:

These examples are specifically designed to impart practical understanding of C# Eval Expression, demonstrating its potent features and adaptable options in a variety of scenarios.

Advanced Usage

Instance Context

Z.Expressions.Eval allows more advanced scenarios, such as operating in a specific context, using variables, and more. Here's an example illustrating the use of instance context:

// CREATE a new instance of EvalContext
var context = new EvalContext();

// USE the `Execute` method from the context created
var list1 = context.Execute<List<int>>("new List<int>() { 1, 2, 3 };");

In this example, we first create a new instance of EvalContext. Then, we use the Execute method from the created context to evaluate and execute a string as a C# expression, which instantiates a new List<int>.

Try it online

Register Type

The RegisterType method allows you to register all types provided for the context. The method also registers extension methods from those types but does not register other static members. For instance, if you register the type "Z.MyNamespace.MyClass", you can subsequently create an expression such as "new MyClass()" or any extension methods from this type.

In the following example, we'll register the types MyClassHelper and MyExtensions to include their extension methods. We'll first demonstrate how to use our class and extension methods in an arithmetic operation. We'll then show how to utilize the IsRegisteredType and UnregisterType methods with MyClassHelper to verify if the type is currently registered and to unregister it.

using System;
using System.Collections.Generic;
using Z.Expressions;

public class Program
{
	public static void Main()
	{
		// Global Context: EvalManager.DefaultContext.RegisterType(typeof(Helper));
		
		var context = new EvalContext();
		context.RegisterType(typeof(MyClassHelper));
		context.RegisterType(typeof(MyExtensions));
		
		var r1 = context.Execute<int>("new MyClassHelper().MyClassHelperID + 2.AddMe(3)"); // return 6
		Console.WriteLine("1 - Result: " + r1);
		
		// Check if the type `MyClassHelper` is registered
		var r2 = context.IsRegisteredType(typeof(MyClassHelper)); // return true
		Console.WriteLine("2 - Result: " + r2);
		
		// Unregister the type `MyClassHelper`
		context.UnregisterType(typeof(MyClassHelper));
		
		// Check the type `MyClassHelper` has been succesfully unregistered
		var r3 = context.IsRegisteredType(typeof(MyClassHelper)); // return false
		Console.WriteLine("3 - Result: " + r3);
	}
	
	public class MyClassHelper
	{
		public int MyClassHelperID { get; set; } = 1;
	}
}

public static class MyExtensions
{	
	public static int AddMe(this int x, int y)
	{
		return x + y;
	}
}

Try it online

Use Options

The SafeMode option allows you to set the context to only allow the usage of registered members and types within expressions. In essence, it enables a secure execution environment for user input, restricting usage to only what you explicitly permit. By default, SafeMode is set to false.

In this example, we demonstrate how SafeMode method. Please ensure to thoroughly understand the SafeMode documentation if you intend to use this option.

// Global Context: EvalManager.DefaultContext.SafeMode = true;

var context = new EvalContext();

context.SafeMode = true;
context.UnregisterAll();

try
{
	var fail = context.Execute("Math.Min(1, 2)");
	Console.WriteLine(fail);
}
catch(Exception ex)
{
	Console.WriteLine("1 - Exception: " + ex.Message);
}

// try again by registering "System.Math" member
context.RegisterMember(typeof(System.Math));
var r2 = context.Execute("Math.Min(1, 2)");
Console.WriteLine("2 - Result: " + r2);

Try it online

Release Notes

For a thorough record of enhancements, bug fixes, and upgrades in each iteration of C# Eval Expression, we recommend referring to the official Release Notes located in our GitHub repository.

The Release Notes offer essential insights about each version, detailing new features, addressing resolved issues, and mentioning any breaking changes (if applicable). We strongly advise reviewing these notes prior to upgrading to a newer version. This practice not only ensures you leverage the full potential of the newly introduced features but also helps prevent unforeseen complications.

License

C# Eval Expression utilizes a paid licensing model. To acquire a license, please visit our official Pricing Page on the Eval Expression website.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  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 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 was computed.  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 was computed.  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. 
.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (16)

Showing the top 5 NuGet packages that depend on Z.Expressions.Eval:

Package Downloads
Z.EntityFramework.Plus.EFCore

Entity Framework Plus extends your DbContext with must-haves features: Include Filter, Auditing, Caching, Query Future, Batch Delete, Batch Update, and more **IMPORTANT** - For EF Core 9.x, use the latest EF Plus v9.x version - For EF Core 8.x, use the latest EF Plus v8.x version - For EF Core 7.x, use the latest EF Plus v7.x version - For EF Core 6.x, use the latest EF Plus v6.x version - For EF Core 5.x, use the latest EF Plus v5.x version - For EF Core 3.x, use the latest EF Plus v3.x version - For EF Core 2.x, use the latest EF Plus v2.x version

Z.EntityFramework.Plus.EF6

Entity Framework Plus extends your DbContext with must-haves features: Include Filter, Auditing, Caching, Query Future, Batch Delete, Batch Update, and more

Z.EntityFramework.Classic

Entity Framework Classic is an EF6 fork with performance enhancement, new features, and .NET Core support. This package is FREE (Community Version) Some features are Prime (Enterprise Version) Prime features can be disabled with "EntityFrameworkManager.IsCommunity = true;"

Z.EntityFramework.Plus.EF5

Entity Framework Plus extends your DbContext with must-haves features: Include Filter, Auditing, Caching, Query Future, Batch Delete, Batch Update, and more EF Core Package: https://www.nuget.org/packages/Z.EntityFramework.Plus.EFCore/ EF6 Package: https://www.nuget.org/packages/Z.EntityFramework.Plus.EF6/

DianFengBaseLib.Infrastructure

配合DDD使用

GitHub repositories (5)

Showing the top 5 popular GitHub repositories that depend on Z.Expressions.Eval:

Repository Stars
zzzprojects/EntityFramework-Plus
Entity Framework Plus extends your DbContext with must-haves features: Include Filter, Auditing, Caching, Query Future, Batch Delete, Batch Update, and more
zzzprojects/EntityFramework.DynamicFilters
Global filtering for Entity Framework.
zzzprojects/Eval-Expression.NET
C# Eval Expression | Evaluate, Compile, and Execute C# code and expression at runtime.
zzzprojects/EntityFramework-Effort
Entity Framework Effort is a powerful tool that enables a convenient way to create automated tests for Entity Framework based applications.
DigitalPlatform/dp2
Integrated Library System / 图书馆集成系统
Version Downloads Last updated
6.2.12 14,292 6/10/2025
6.2.11 3,832 5/25/2025
6.2.10 99,418 5/6/2025
6.2.9 105,637 4/8/2025
6.2.8 265,617 3/10/2025
6.2.7 7,550 2/24/2025
6.2.6 171,565 2/11/2025
6.2.5 264,238 1/14/2025
6.2.4 255,161 12/17/2024
6.2.3 308,981 11/26/2024
6.2.2 305,946 11/12/2024
6.2.2-beta2 115 11/14/2024
6.2.2-beta1 116 11/14/2024
6.2.1 314,836 10/22/2024
6.2.0 367,335 9/23/2024
6.2.0-beta1 136 10/2/2024
6.1.10 365,615 8/27/2024
6.1.9 231,394 8/12/2024
6.1.8 273,385 7/22/2024
6.1.7 612,265 6/18/2024
6.1.6 161,558 6/3/2024
6.1.2 1,115,852 3/11/2024
6.1.1 244,993 2/27/2024
6.1.0 520,380 2/13/2024
6.0.6 736,282 1/15/2024
6.0.5 328,398 12/18/2023
6.0.4 3,779 12/11/2023
6.0.3 151,895 12/5/2023
6.0.2 117,471 11/28/2023
6.0.1 1,269 11/28/2023
6.0.0 297,315 11/15/2023
5.0.12 3,910 11/7/2023
5.0.11 490,773 10/17/2023
5.0.10 313,753 9/26/2023
5.0.9 262,540 9/11/2023
5.0.8 255,407 8/15/2023
5.0.7 686,956 7/11/2023
5.0.6 321,422 6/12/2023
5.0.5 8,892 5/30/2023
5.0.4 509,934 5/16/2023
5.0.3 413,341 4/17/2023
5.0.2 364,918 3/20/2023
5.0.1 538,009 2/20/2023
5.0.0 856,250 1/17/2023
4.0.92 462,067 12/20/2022
4.0.91 467,204 12/5/2022
4.0.90 643,027 11/14/2022
4.0.89 1,028,470 10/10/2022
4.0.88 1,235,550 9/12/2022
4.0.87 906,033 8/16/2022
4.0.86 1,069,416 7/19/2022
4.0.85 807,138 6/14/2022
4.0.84 146,073 6/7/2022
4.0.83 24,708 5/26/2022
4.0.82 456,537 5/24/2022
4.0.81 217,101 5/17/2022
4.0.80 208,119 5/10/2022
4.0.79 843,588 4/12/2022
4.0.78 760,033 3/30/2022
4.0.77 806,978 3/15/2022
4.0.76 327,738 3/1/2022
4.0.75 154,931 2/22/2022
4.0.74 329,001 2/14/2022
4.0.73 134,484 2/8/2022
4.0.72 22,867 2/1/2022
4.0.71 609,512 1/18/2022
4.0.70 303,114 1/11/2022
4.0.69 2,291,076 12/30/2021
4.0.68 19,252 12/15/2021
4.0.67 272,944 12/14/2021
4.0.66 4,294 12/7/2021
4.0.65 3,081 11/30/2021
4.0.64 340,222 11/24/2021
4.0.63 362,622 11/17/2021
4.0.62 311,251 11/9/2021
4.0.61 3,017 11/4/2021
4.0.60 323,461 10/27/2021
4.0.59 150,537 10/20/2021
4.0.58 91,009 10/13/2021
4.0.57 2,750 10/12/2021
4.0.56 7,305 10/6/2021
4.0.55 6,409 9/29/2021
4.0.54 573,243 9/15/2021
4.0.53 111,555 9/8/2021
4.0.52 206,284 9/1/2021
4.0.51 92,590 8/25/2021
4.0.50 172,399 8/17/2021
4.0.49 189,264 8/4/2021
4.0.48 462,816 7/28/2021
4.0.47 201,050 7/20/2021
4.0.46 238,450 7/13/2021
4.0.45 538,408 6/16/2021
4.0.44 76,509 6/14/2021
4.0.43 519,160 5/12/2021
4.0.42 139,465 5/3/2021
4.0.41 220,803 4/26/2021
4.0.40 2,492 4/22/2021
4.0.39 170,826 4/19/2021
4.0.38 157,604 4/7/2021
4.0.37 282,478 3/24/2021
4.0.37-beta1 1,726 4/1/2021
4.0.36 148,629 3/16/2021
4.0.35 38,898 3/15/2021
4.0.34 210,365 3/10/2021
4.0.33 11,750 2/23/2021
4.0.32 589,974 2/16/2021
4.0.31 158,566 2/10/2021
4.0.30 194,702 2/2/2021
4.0.29 324,573 1/13/2021
4.0.28 598,865 12/14/2020
4.0.27 70,617 12/8/2020
4.0.26 106,809 12/1/2020
4.0.25 82,782 11/27/2020
4.0.24 212,398 11/11/2020
4.0.23 224,200 10/30/2020
4.0.22 789,049 10/11/2020
4.0.21 57,920 10/7/2020
4.0.20 3,457 10/5/2020
4.0.19 104,566 9/30/2020
4.0.18 4,412 9/29/2020
4.0.17 35,020 9/24/2020
4.0.16 329,698 9/14/2020
4.0.15 239,617 8/31/2020
4.0.14 7,310 8/25/2020
4.0.13 5,346 8/17/2020
4.0.12 241,346 8/11/2020
4.0.11 102,259 8/3/2020
4.0.10 19,597 7/28/2020
4.0.9 160,851 7/22/2020
4.0.8 3,309 7/19/2020
4.0.7 2,230 7/19/2020
4.0.6 263,823 7/14/2020
4.0.5 2,317 7/13/2020
4.0.4 90,442 7/12/2020
4.0.3 13,107 7/5/2020
4.0.2 8,897 6/30/2020
4.0.1 700,697 6/14/2020
4.0.0 80,843 6/1/2020
3.1.12 24,542 5/25/2020
3.1.11 690,942 5/14/2020
3.1.10 476,794 4/14/2020
3.1.9 50,088 4/3/2020
3.1.8 634,930 3/16/2020
3.1.7 6,068 3/10/2020
3.1.6 573,870 2/21/2020
3.1.5 313,267 2/18/2020
3.1.4 19,987 2/15/2020
3.1.3 61,468 2/7/2020
3.1.2 505,809 1/27/2020
3.1.1 4,302 1/23/2020
3.1.0 9,142 1/14/2020
3.0.14 6,572 1/13/2020
3.0.13 26,306 1/9/2020
3.0.12 10,260 1/3/2020
3.0.11 10,964 12/19/2019
3.0.10 4,049 12/17/2019
3.0.9 522,459 12/16/2019
3.0.8 5,957 12/11/2019
3.0.7 325,722 11/25/2019
3.0.6 23,763 11/18/2019
3.0.5 3,932 11/14/2019
3.0.4 7,874 11/12/2019
3.0.3 621,616 10/30/2019
3.0.2 2,318 10/30/2019
3.0.1 13,721 10/29/2019
3.0.0 2,703 10/29/2019
2.9.57 15,055 10/16/2019
2.9.56 2,741 10/10/2019
2.9.55 6,213 10/2/2019
2.9.54 16,364 9/22/2019
2.9.52 3,126 9/6/2019
2.9.51 2,352 9/5/2019
2.9.50 2,327 9/4/2019
2.9.49 2,808 8/29/2019
2.9.48 8,474 8/24/2019
2.9.47 2,396 8/24/2019
2.9.46 39,968 8/15/2019
2.9.45 161,091 7/28/2019
2.9.44 3,178 7/15/2019
2.9.43 3,602 7/9/2019
2.9.42 6,339 7/4/2019
2.9.41 2,524 7/3/2019
2.9.40 2,482 7/1/2019
2.9.39 16,863 6/29/2019
2.9.38 2,360 6/25/2019
2.9.37 2,884 6/12/2019
2.9.36 2,524 6/7/2019
2.9.35 2,350 6/4/2019
2.9.34 2,649 5/31/2019
2.9.33 4,353 5/31/2019
2.9.32 4,523 5/23/2019
2.9.31 45,081 5/20/2019
2.9.30 2,427 5/17/2019
2.9.29 2,473 5/9/2019
2.9.28 2,294 5/9/2019
2.9.27 4,450 5/5/2019
2.9.26 2,322 5/3/2019
2.9.25 7,289 4/30/2019
2.9.24 3,060 4/18/2019
2.9.22 2,494 4/16/2019
2.9.21 11,072 4/7/2019
2.9.20 32,670 3/30/2019
2.9.19 2,596 3/27/2019
2.9.18 2,419 3/26/2019
2.9.17 2,620 3/21/2019
2.9.16 2,342 3/20/2019
2.9.15 2,376 3/20/2019
2.9.14 2,504 3/16/2019
2.9.13 2,421 3/16/2019
2.9.12 95,558 2/27/2019
2.9.11 2,708 2/20/2019
2.9.10 2,433 2/18/2019
2.9.9 2,370 2/16/2019
2.9.8 3,052 2/13/2019
2.9.7 2,796 2/8/2019
2.9.6 6,300 1/30/2019
2.9.5 9,053 1/13/2019
2.9.4 6,416 12/30/2018
2.9.3 3,001 12/13/2018
2.9.2 2,592 12/13/2018
2.9.1 2,665 12/12/2018
2.9.0 2,503 12/12/2018
2.8.9 3,048 12/11/2018
2.8.8 70,202 11/29/2018
2.8.7 3,028 11/28/2018
2.8.6 2,526 11/27/2018
2.8.5 3,758 11/20/2018
2.8.4 2,648 11/18/2018
2.8.3 2,581 11/17/2018
2.8.2 2,589 11/17/2018
2.8.1 3,025 11/14/2018
2.8.0 2,526 11/14/2018
2.7.13 5,070 10/29/2018
2.7.12 9,644 10/28/2018
2.7.11 2,648 10/23/2018
2.7.10 5,398 10/17/2018
2.7.9 5,156 10/7/2018
2.7.8 5,652 9/29/2018
2.7.7 5,474 8/31/2018
2.7.6 6,146 8/30/2018
2.7.5 3,001 8/18/2018
2.7.4 5,463 8/16/2018
2.7.3 3,551 8/16/2018
2.7.2 4,920 7/31/2018
2.7.1 3,367 7/19/2018
2.7.0 3,426 7/5/2018
2.6.5 3,278 6/29/2018
2.6.4 3,930 5/31/2018
2.6.3 4,198 5/2/2018
2.6.2 3,300 4/30/2018
2.6.1 4,208 3/30/2018
2.6.0 3,205 3/26/2018
2.5.0 3,184 3/20/2018
2.4.21 3,006 3/20/2018
2.4.20 3,095 3/16/2018
2.4.19 3,579 2/27/2018
2.4.18 3,602 2/12/2018
2.4.17 2,925 2/6/2018
2.4.16 3,182 2/2/2018
2.4.15 3,090 1/31/2018
2.4.14 3,065 1/31/2018
2.4.13 3,125 1/23/2018
2.4.12 3,056 1/16/2018
2.4.11 3,196 1/8/2018
2.4.10 3,351 1/5/2018
2.4.9 3,360 12/29/2017
2.4.8 4,955 12/6/2017
2.4.7 3,057 11/30/2017
2.4.6 3,033 11/27/2017
2.4.5 3,278 11/16/2017
2.4.4 3,087 11/13/2017
2.4.3 4,543 11/7/2017
2.4.2 3,024 11/1/2017
2.4.1 3,165 10/30/2017
2.4.0 13,106 9/30/2017
2.3.0 3,179 9/30/2017
2.2.1 3,100 9/24/2017
2.2.0-beta1 2,689 9/20/2017
2.1.15 3,898 8/31/2017
2.1.14 3,000 8/8/2017
2.1.13 3,117 8/2/2017
2.1.12 2,876 8/1/2017
2.1.11 2,996 7/27/2017
2.1.10 3,049 7/25/2017
2.1.9 3,019 7/11/2017
2.1.8 9,065 7/10/2017
2.1.7 3,042 7/7/2017
2.1.6 2,930 7/6/2017
2.1.5 2,986 7/3/2017
2.1.4 3,467 6/29/2017