BlazarTech.QueryableValues.SqlServer
8.1.1
dotnet add package BlazarTech.QueryableValues.SqlServer --version 8.1.1
NuGet\Install-Package BlazarTech.QueryableValues.SqlServer -Version 8.1.1
<PackageReference Include="BlazarTech.QueryableValues.SqlServer" Version="8.1.1" />
paket add BlazarTech.QueryableValues.SqlServer --version 8.1.1
#r "nuget: BlazarTech.QueryableValues.SqlServer, 8.1.1"
// Install BlazarTech.QueryableValues.SqlServer as a Cake Addin #addin nuget:?package=BlazarTech.QueryableValues.SqlServer&version=8.1.1 // Install BlazarTech.QueryableValues.SqlServer as a Cake Tool #tool nuget:?package=BlazarTech.QueryableValues.SqlServer&version=8.1.1
QueryableValues
🤔💭 TLDR; By using QueryableValues, you can incorporate in-memory collections into your EF queries with outstanding performance and flexibility.
This library allows you to efficiently compose an IEnumerable<T> in your Entity Framework Core queries when using the SQL Server Database Provider. You can accomplish this by using the AsQueryableValues
extension method that's available on the DbContext class. The query is processed in a single round trip to the server, in a way that preserves its execution plan, even when the values within the IEnumerable<T> are changed on subsequent executions.
Highlights
- ✨ Enables the composition of in-memory data within your queries, utilizing both simple and complex types.
- 👌 Works with all versions of SQL Server supported by Entity Framework Core.
- ⚡ Automatically uses the most efficient strategy compatible with your SQL Server instance and configuration.
- ✅ Boasts over 140 tests for reliability and compatibility, giving you added confidence.
For a detailed explanation of the problem solved by QueryableValues, please continue reading here.
💡 Still on Entity Framework 6 (non-core)? Then QueryableValues
EF6 Edition
is what you need.
Your Support is Appreciated!
If you feel that this solution has provided you some value, please consider buying me a ☕.
Your ⭐ on this repository also helps! Thanks! 🖖🙂
Getting Started
Installation
QueryableValues is distributed as a NuGet Package. The major version number of this library is aligned with the version of Entity Framework Core by which it's supported (e.g. If you are using EF Core 5, then you must use version 5 of QueryableValues).
Configuration
Look for the place in your code where you are setting up your DbContext and calling the UseSqlServer extension method, then use a lambda expression to access the SqlServerDbContextOptionsBuilder
provided by it. It is on this builder that you must call the UseQueryableValues
extension method as shown in the following simplified examples:
When using the OnConfiguring
method inside your DbContext:
using BlazarTech.QueryableValues;
public class MyDbContext : DbContext
{
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder.UseSqlServer(
"MyConnectionString",
sqlServerOptionsBuilder =>
{
sqlServerOptionsBuilder.UseQueryableValues();
}
);
}
}
When setting up the DbContext at registration time using dependency injection:
using BlazarTech.QueryableValues;
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddDbContext<MyDbContext>(optionsBuilder => {
optionsBuilder.UseSqlServer(
"MyConnectionString",
sqlServerOptionsBuilder =>
{
sqlServerOptionsBuilder.UseQueryableValues();
}
);
});
}
}
💡
UseQueryableValues
offers an optionaloptions
delegate for additional configurations.
How Do You Use It?
The AsQueryableValues
extension method is provided by the BlazarTech.QueryableValues
namespace; therefore, you must add the following using
directive to your source code file for it to appear as a method of your DbContext instance:
using BlazarTech.QueryableValues;
💡 If you access your DbContext via an interface, you can also make the
AsQueryableValues
extension methods available on it by inheriting from theIQueryableValuesEnabledDbContext
interface.
Below are a few examples composing a query using the values provided by an IEnumerable<T>.
Simple Type Examples
💡 Supports Byte, Int16, Int32, Int64, Decimal, Single, Double, DateTime, DateTimeOffset, DateOnly, TimeOnly, Guid, Char, String, and Enum.
Using the Contains LINQ method:
// Sample values.
IEnumerable<int> values = Enumerable.Range(1, 10);
// Example #1 (LINQ method syntax)
var myQuery1 = dbContext.MyEntities
.Where(i => dbContext
.AsQueryableValues(values)
.Contains(i.MyEntityID)
)
.Select(i => new
{
i.MyEntityID,
i.PropA
});
// Example #2 (LINQ query syntax)
var myQuery2 =
from i in dbContext.MyEntities
where dbContext
.AsQueryableValues(values)
.Contains(i.MyEntityID)
select new
{
i.MyEntityID,
i.PropA
};
Using the Join LINQ method:
// Sample values.
IEnumerable<int> values = Enumerable.Range(1, 10);
// Example #1 (LINQ method syntax)
var myQuery1 = dbContext.MyEntities
.Join(
dbContext.AsQueryableValues(values),
i => i.MyEntityID,
v => v,
(i, v) => new
{
i.MyEntityID,
i.PropA
}
);
// Example #2 (LINQ query syntax)
var myQuery2 =
from i in dbContext.MyEntities
join v in dbContext.AsQueryableValues(values) on i.MyEntityID equals v
select new
{
i.MyEntityID,
i.PropA
};
Complex Type Example
💡 Must be an anonymous or user-defined type with one or more simple type properties, including Boolean.
// Performance Tip:
// If your IEnumerable<T> item type (T) has many properties, project only
// the ones you need to a new variable and use it in your query.
var projectedItems = items.Select(i => new { i.CategoryId, i.ColorName });
// Example #1 (LINQ method syntax)
var myQuery1 = dbContext.Product
.Join(
dbContext.AsQueryableValues(projectedItems),
p => new { p.CategoryId, p.ColorName },
pi => new { pi.CategoryId, pi.ColorName },
(p, pi) => new
{
p.ProductId,
p.Description
}
);
// Example #2 (LINQ query syntax)
var myQuery2 =
from p in dbContext.Product
join pi in dbContext.AsQueryableValues(projectedItems) on new { p.CategoryId, p.ColorName } equals new { pi.CategoryId, pi.ColorName }
select new
{
p.ProductId,
p.Description
};
About Complex Types
⚠️ All the data provided by this type is transmitted to the server; therefore, ensure that it only contains the properties you need for your query. Not following this recommendation will degrade the query's performance.
⚠️ There is a limit of up to 10 properties for any given simple type (e.g. cannot have more than 10 Int32 properties). Exceeding that limit will cause an exception and may also suggest that you should rethink your strategy.
Do You Want To Know More? 📚
Please take a look at the repository.
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. |
-
net8.0
- Microsoft.EntityFrameworkCore.SqlServer (>= 8.0.0)
- Microsoft.Extensions.ObjectPool (>= 8.0.0)
- Microsoft.IO.RecyclableMemoryStream (>= 2.3.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
8.1.1 | 56,974 | 2/8/2024 |
8.1.0 | 9,568 | 12/7/2023 |
8.0.0 | 1,824 | 11/26/2023 |
7.4.3 | 92,212 | 2/8/2024 |
7.4.2 | 2,123 | 12/7/2023 |
7.4.1 | 6,216 | 11/26/2023 |
7.4.0 | 57,794 | 6/25/2023 |
7.3.0 | 3,935 | 5/20/2023 |
7.2.0 | 3,732 | 3/27/2023 |
7.1.0 | 2,311 | 3/14/2023 |
7.0.0 | 16,140 | 11/13/2022 |
7.0.0-preview.2 | 179 | 9/3/2022 |
7.0.0-preview.1 | 144 | 8/7/2022 |
6.9.3 | 2,275 | 2/8/2024 |
6.9.2 | 13,963 | 12/7/2023 |
6.9.1 | 159 | 11/26/2023 |
6.9.0 | 12,924 | 6/25/2023 |
6.8.0 | 101,194 | 5/20/2023 |
6.7.0 | 3,607 | 3/27/2023 |
6.6.0 | 593 | 3/14/2023 |
6.5.0 | 94,959 | 9/3/2022 |
6.4.0 | 7,300 | 7/14/2022 |
6.3.0 | 11,573 | 1/4/2022 |
6.2.0 | 373 | 12/27/2021 |
6.1.0 | 351 | 12/9/2021 |
6.0.0 | 1,053 | 12/6/2021 |
5.9.3 | 150 | 2/8/2024 |
5.9.2 | 160 | 12/7/2023 |
5.9.1 | 142 | 11/26/2023 |
5.9.0 | 186 | 6/25/2023 |
5.8.0 | 183 | 5/20/2023 |
5.7.0 | 248 | 3/27/2023 |
5.6.0 | 326 | 3/14/2023 |
5.5.0 | 1,805 | 9/3/2022 |
5.4.0 | 1,094 | 7/14/2022 |
5.3.0 | 31,820 | 1/4/2022 |
5.2.0 | 351 | 12/27/2021 |
5.1.0 | 356 | 12/9/2021 |
5.0.0 | 349 | 12/6/2021 |
3.9.3 | 124 | 2/8/2024 |
3.9.2 | 146 | 12/7/2023 |
3.9.1 | 152 | 11/26/2023 |
3.9.0 | 265 | 6/25/2023 |
3.8.0 | 188 | 5/20/2023 |
3.7.0 | 263 | 3/27/2023 |
3.6.0 | 269 | 3/14/2023 |
3.5.0 | 463 | 9/3/2022 |
3.4.0 | 492 | 7/14/2022 |
3.3.0 | 1,452 | 1/4/2022 |
3.2.0 | 301 | 12/27/2021 |
3.1.0 | 338 | 12/9/2021 |
3.0.0 | 434 | 12/6/2021 |