ReHackt.Linq 8.0.120

There is a newer version of this package available.
See the version list below for details.
dotnet add package ReHackt.Linq --version 8.0.120
                    
NuGet\Install-Package ReHackt.Linq -Version 8.0.120
                    
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="ReHackt.Linq" Version="8.0.120" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ReHackt.Linq" Version="8.0.120" />
                    
Directory.Packages.props
<PackageReference Include="ReHackt.Linq" />
                    
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 ReHackt.Linq --version 8.0.120
                    
#r "nuget: ReHackt.Linq, 8.0.120"
                    
#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.
#:package ReHackt.Linq@8.0.120
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ReHackt.Linq&version=8.0.120
                    
Install as a Cake Addin
#tool nuget:?package=ReHackt.Linq&version=8.0.120
                    
Install as a Cake Tool

ReHackt.Linq

Some useful System.Linq.IQueryable extensions such as filtering, ordering, paging...

Install

Get it on <a href="https://www.nuget.org/packages/ReHackt.Linq"><img src="https://www.nuget.org/Content/gallery/img/default-package-icon.svg" height=18 style="height:18px;" /> NuGet</a>

QueryableFilter

QueryableFilter<T> allows to dynamically filter an IQueryable<T> with a query string. For example, this can be useful for an API whose clients can filter a collection of entities on any of its properties, or create complex logical queries.

For example

string query = @"Name eq ""Bond"" and (""james"" in Email or (Status in [1, 2] and ""007"" in Codes)) and (Amount lt 1000 or IsEnabled eq false)";

if(QueryableFilter.TryParse(query, out QueryableFilter<Agent> filter) {
    IQueryable<Agent> agents = _agentManager.Agents.Filter(filter);
}
else { /* Handle invalid query */ };

Is equivalent to

IQueryable<Agent> agents = _agentManager.Agents
    .Where(u => u.Name == "Bond"
        && (u.Email.Contains("james")
            || (new int[] { 1, 2 }.Contains(Status) && u.Codes.Contains("007")))
        && (u.Amount < 1000 || u.IsEnabled == false);

Supported in query

  • Boolean operators: and, or, not
  • Comparison operators: eq, ne, gt, gte (ge), lt, lte (le), in (string.Contains or IList.Contains)
  • Value types: bool?, DateTimeOffset?, double?, int?, enum, null, string, DateTimeOffset?[], double?[], int?[], string[]
  • Parentheses
  • Property names (nested properties and collection properties supported)

IQueryable extensions

Filtering

Filter

Filter allows to apply a QueryableFilter<T> to the input sequence using LINQ method syntax.

source.Filter(filter) // filter is a QueryableFilter<T>

Is syntactic sugar for

filter.Apply(source)

This method also allows you to directly filter the input sequence with a query string (implicitly creating a QueryableFilter<T>). Be careful, this can throw an argument exception if the query string is not valid.

source.Filter(filterQuery) // filterQuery is a string

Is syntactic sugar for

QueryableFilter.TryParse(filterQuery, out QueryableFilter<T> filter) ?
    source.Filter(filter) :
    throw new ArgumentException("Invalid filter query", nameof(filterQuery))
WhereIf
source.WhereIf(condition, predicate)

Is syntactic sugar for

condition ? source.Where(predicate) : source

This allows you to keep the LINQ method syntax to apply filters according to a condition that does not depend on the element being tested.

For example

return source
            .Join(...)
            .Where(...)
            .WhereIf(condition1, predicate1)
            .WhereIf(condition2, predicate2)
            .OrderBy(...)
            .Select(...);

Is equivalent to

source = source            
            .Join(...)
            .Where(...);

if(condition1) {
    source = source.Where(predicate1);
} 

if(condition2) {
    source = source.Where(predicate2);
}

return source
            .OrderBy(...)
            .Select(...);

Ordering

// TODO Write documentation of Sort(...)

Paging

PageBy
source.PageBy(page, pageSize)

Is syntactic sugar for

source.Skip(((page < 1 ? 1 : page) - 1) * pageSize).Take(pageSize)
Product 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.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on ReHackt.Linq:

Package Downloads
ReHackt.AspNetCore.Abstractions

Package Description

ReHackt.Linq.AutoMapper

Extends ReHackt.Linq with object-object mapping using AutoMapper profiles.

ReHackt.Schema

Package Description

ReHackt.Linq.Benchmarks

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
8.0.133 176 9/10/2025
8.0.132 157 9/10/2025
8.0.131 154 9/10/2025
8.0.130 159 9/10/2025
8.0.129 190 9/1/2025
8.0.128 184 8/20/2025
8.0.127 177 8/18/2025
8.0.126 202 8/15/2025
8.0.125 140 8/15/2025
8.0.124 173 8/14/2025
8.0.123 166 8/14/2025
8.0.122 169 8/14/2025
8.0.121 176 8/13/2025
8.0.120 272 8/5/2025
8.0.119 172 8/4/2025
8.0.118 119 8/1/2025
8.0.117 128 7/31/2025
8.0.116 133 7/31/2025
8.0.115 229 7/17/2025
8.0.114 879 6/11/2025
8.0.113 260 5/28/2025
8.0.112 253 5/19/2025
8.0.111 352 5/13/2025
8.0.110 347 4/17/2025
8.0.109 289 4/16/2025
8.0.108 306 4/9/2025
8.0.107 321 4/3/2025
8.0.106 241 3/29/2025
8.0.105 215 3/29/2025
8.0.104 210 3/29/2025
8.0.103 207 3/29/2025
8.0.102 224 3/28/2025
8.0.101 231 3/28/2025
8.0.100 221 3/28/2025
8.0.99 234 3/28/2025
8.0.98 235 3/28/2025
8.0.97 217 3/28/2025
8.0.96 233 3/28/2025
8.0.95 238 3/27/2025
8.0.94 235 3/27/2025
8.0.93 603 3/25/2025
8.0.92 270 3/18/2025
8.0.91 261 3/17/2025
8.0.90 280 3/17/2025
8.0.89 238 3/16/2025
8.0.88 243 3/16/2025
8.0.87 293 3/11/2025
8.0.86 277 3/11/2025
8.0.85 340 3/6/2025
8.0.84 237 2/23/2025
8.0.83 218 2/23/2025
8.0.82 212 2/22/2025
8.0.81 200 2/22/2025
8.0.80 226 2/19/2025
8.0.79 229 2/19/2025
8.0.78 241 2/18/2025
8.0.77 234 2/14/2025
8.0.76 225 2/14/2025
8.0.75 228 2/12/2025
8.0.74 217 2/11/2025
8.0.73 228 2/11/2025
8.0.72 226 2/11/2025
8.0.71 266 2/3/2025
8.0.70 228 1/30/2025
8.0.69 212 1/20/2025
8.0.68 172 1/14/2025
8.0.67 215 1/6/2025
8.0.66 197 1/6/2025
8.0.65 252 1/3/2025
8.0.64 258 12/20/2024
8.0.63 224 12/20/2024
8.0.62 222 12/19/2024
8.0.61 274 12/16/2024
8.0.60 220 12/13/2024
8.0.59 250 11/26/2024
8.0.58 224 11/26/2024
8.0.57 215 11/25/2024
8.0.56 211 11/25/2024
8.0.55 223 11/23/2024
8.0.54 387 11/21/2024
8.0.53 226 11/19/2024
8.0.52 210 11/19/2024
8.0.51 208 11/19/2024
8.0.50 202 11/18/2024
8.0.49 212 11/14/2024
8.0.48 216 11/14/2024
8.0.47 213 11/13/2024
8.0.46 659 10/13/2024
8.0.45 211 10/11/2024
8.0.44 212 10/11/2024
8.0.43 229 10/10/2024
8.0.42 216 10/10/2024
8.0.41 227 10/8/2024
8.0.40 221 10/7/2024
8.0.39 229 10/7/2024
8.0.38 205 10/7/2024
8.0.37 210 10/7/2024
8.0.36 231 10/3/2024
8.0.35 224 10/3/2024
8.0.34 219 10/2/2024
8.0.33 250 10/2/2024
8.0.32 249 9/27/2024
8.0.31 279 9/12/2024
8.0.30 253 9/12/2024
8.0.29 247 9/12/2024
8.0.28 253 9/3/2024
8.0.27 276 8/26/2024
8.0.26 225 8/4/2024
8.0.25 210 8/4/2024
8.0.24 200 8/4/2024
8.0.23 190 8/3/2024
8.0.22 183 8/3/2024
8.0.21 291 7/9/2024
8.0.20 241 7/6/2024
8.0.19 250 7/4/2024
8.0.18 498 6/17/2024
8.0.17 257 6/3/2024
8.0.16 216 6/3/2024
8.0.15 254 5/29/2024
8.0.14 243 5/15/2024
8.0.13 336 4/16/2024
8.0.12 262 4/10/2024
8.0.11 359 3/14/2024
8.0.10 407 2/21/2024
8.0.9 479 2/15/2024
8.0.8 466 2/8/2024
8.0.7 479 2/6/2024
8.0.6 577 1/29/2024
8.0.5 523 1/18/2024
8.0.4 513 1/16/2024
8.0.3 555 1/15/2024
8.0.2 535 1/14/2024
8.0.1 514 1/12/2024
8.0.0 577 12/19/2023
7.3.13 710 11/14/2023
7.3.12 620 11/13/2023
7.3.11 1,198 9/16/2023
7.3.10 739 9/15/2023
7.3.9 922 8/16/2023
7.3.8 958 7/12/2023
7.3.7 870 7/12/2023
7.3.6 861 7/10/2023
7.3.5 938 7/3/2023
7.3.4 1,045 6/8/2023
7.3.3 1,065 5/29/2023
7.3.2 1,177 4/27/2023
7.3.1 1,087 4/27/2023
7.3.0 1,107 4/17/2023
7.2.1 1,091 4/7/2023
7.2.0 1,082 4/6/2023
7.1.4 1,128 3/30/2023
7.1.3 1,084 3/29/2023
7.1.2 1,158 3/29/2023
7.1.0 1,311 3/28/2023
7.0.1 2,300 2/1/2023
7.0.0 1,617 12/2/2022
1.1.2 5,297 6/23/2022
1.1.1 2,297 6/23/2022
1.1.0 2,937 6/9/2022
1.0.9 1,892 6/9/2022
1.0.8 2,000 6/8/2022
1.0.7 3,366 5/13/2022
1.0.6 2,204 5/5/2022
1.0.5 6,055 4/8/2022
1.0.4 2,854 3/23/2022
1.0.3 2,891 3/9/2022
1.0.2 1,386 3/7/2022
1.0.1 1,432 3/7/2022
1.0.0 1,626 2/27/2022
1.0.0-alpha.14 237 2/24/2022
1.0.0-alpha.13 234 2/24/2022
1.0.0-alpha.12 221 2/24/2022
1.0.0-alpha.11 289 2/21/2022