ReHackt.Linq.AutoMapper 8.0.126

dotnet add package ReHackt.Linq.AutoMapper --version 8.0.126
                    
NuGet\Install-Package ReHackt.Linq.AutoMapper -Version 8.0.126
                    
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.AutoMapper" Version="8.0.126" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ReHackt.Linq.AutoMapper" Version="8.0.126" />
                    
Directory.Packages.props
<PackageReference Include="ReHackt.Linq.AutoMapper" />
                    
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.AutoMapper --version 8.0.126
                    
#r "nuget: ReHackt.Linq.AutoMapper, 8.0.126"
                    
#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.AutoMapper@8.0.126
                    
#: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.AutoMapper&version=8.0.126
                    
Install as a Cake Addin
#tool nuget:?package=ReHackt.Linq.AutoMapper&version=8.0.126
                    
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 (1)

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

Package Downloads
ReHackt.AspNetCore.AutoMapper

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
8.0.126 9 8/15/2025
8.0.125 17 8/15/2025
8.0.124 41 8/14/2025
8.0.123 41 8/14/2025
8.0.122 43 8/14/2025
8.0.121 44 8/13/2025
8.0.120 169 8/5/2025
8.0.119 128 8/4/2025
8.0.118 71 8/1/2025
8.0.117 85 7/31/2025
8.0.116 88 7/31/2025
8.0.115 120 7/17/2025
8.0.114 769 6/11/2025
8.0.113 205 5/28/2025
8.0.112 204 5/19/2025
8.0.111 282 5/13/2025
8.0.110 310 4/17/2025
8.0.109 244 4/16/2025
8.0.108 253 4/9/2025
8.0.107 252 4/3/2025
8.0.106 198 3/29/2025
8.0.105 154 3/29/2025
8.0.104 154 3/29/2025
8.0.103 150 3/29/2025
8.0.102 175 3/28/2025
8.0.101 167 3/28/2025
8.0.100 181 3/28/2025
8.0.99 169 3/28/2025
8.0.98 175 3/28/2025
8.0.97 165 3/28/2025
8.0.96 181 3/28/2025
8.0.95 182 3/27/2025
8.0.94 178 3/27/2025
8.0.93 528 3/25/2025
8.0.92 208 3/18/2025
8.0.91 201 3/17/2025
8.0.90 199 3/17/2025
8.0.89 191 3/16/2025
8.0.88 193 3/16/2025
8.0.87 246 3/11/2025
8.0.86 233 3/11/2025
8.0.85 290 3/6/2025
8.0.84 171 2/23/2025
8.0.83 159 2/23/2025
8.0.82 141 2/22/2025
8.0.81 136 2/22/2025
8.0.80 151 2/19/2025
8.0.79 159 2/19/2025
8.0.78 157 2/18/2025
8.0.77 154 2/14/2025
8.0.76 147 2/14/2025
8.0.75 161 2/12/2025
8.0.74 146 2/11/2025
8.0.73 154 2/11/2025
8.0.72 155 2/11/2025
8.0.71 183 2/3/2025
8.0.70 167 1/30/2025
8.0.69 146 1/20/2025
8.0.68 115 1/14/2025
8.0.67 146 1/6/2025
8.0.66 144 1/6/2025
8.0.65 195 1/3/2025
8.0.64 202 12/20/2024
8.0.63 162 12/20/2024
8.0.62 165 12/19/2024
8.0.61 206 12/16/2024
8.0.60 151 12/13/2024
8.0.59 185 11/26/2024
8.0.58 167 11/26/2024
8.0.57 154 11/25/2024
8.0.56 151 11/25/2024
8.0.55 160 11/23/2024
8.0.54 157 11/21/2024
8.0.53 154 11/19/2024
8.0.52 156 11/19/2024
8.0.51 150 11/19/2024
8.0.50 140 11/18/2024
8.0.49 153 11/14/2024
8.0.48 145 11/14/2024
8.0.47 145 11/13/2024
8.0.46 229 10/13/2024
8.0.45 158 10/11/2024
8.0.44 152 10/11/2024
8.0.43 156 10/10/2024
8.0.42 171 10/10/2024
8.0.41 168 10/8/2024
8.0.40 149 10/7/2024
8.0.39 166 10/7/2024
8.0.38 149 10/7/2024
8.0.37 147 10/7/2024
8.0.36 151 10/3/2024
8.0.35 154 10/3/2024
8.0.34 163 10/2/2024
8.0.33 188 10/2/2024
8.0.32 191 9/27/2024
8.0.31 208 9/12/2024
8.0.30 168 9/12/2024
8.0.29 169 9/12/2024
8.0.28 201 9/3/2024
8.0.27 205 8/26/2024
8.0.26 147 8/4/2024
8.0.25 148 8/4/2024
8.0.24 125 8/4/2024
8.0.23 146 8/3/2024
8.0.22 141 8/3/2024
8.0.21 171 7/9/2024
8.0.20 188 7/6/2024
8.0.19 164 7/4/2024
8.0.18 415 6/17/2024
8.0.17 210 6/3/2024
8.0.16 171 6/3/2024
8.0.15 184 5/29/2024
8.0.14 169 5/15/2024
8.0.13 270 4/16/2024
8.0.12 187 4/10/2024
8.0.11 234 3/14/2024
8.0.10 215 2/21/2024
8.0.9 265 2/15/2024
8.0.8 251 2/8/2024
8.0.7 267 2/6/2024
8.0.6 265 1/29/2024
8.0.5 277 1/18/2024
8.0.4 289 1/16/2024
8.0.3 293 1/15/2024
8.0.2 268 1/14/2024
8.0.1 275 1/12/2024
8.0.0 312 12/19/2023
7.3.13 355 11/14/2023
7.3.12 310 11/13/2023
7.3.11 457 9/16/2023
7.3.10 361 9/15/2023
7.3.9 498 8/16/2023
7.3.8 500 7/12/2023
7.3.7 404 7/12/2023
7.3.6 400 7/10/2023
7.3.5 488 7/3/2023
7.3.4 506 6/8/2023
7.3.3 532 5/29/2023
7.3.2 651 4/27/2023
7.3.1 517 4/27/2023
7.3.0 545 4/17/2023
7.2.1 537 4/7/2023
7.2.0 526 4/6/2023
7.1.4 579 3/30/2023
7.1.3 558 3/29/2023
7.1.2 576 3/29/2023
7.1.0 754 3/28/2023
7.0.2 973 2/19/2023
7.0.1 603 2/1/2023
7.0.0 1,085 12/2/2022
1.1.3 2,762 7/5/2022
1.1.2 516 6/23/2022
1.1.1 1,517 6/23/2022
1.1.0 1,652 6/9/2022
1.0.9 1,093 6/9/2022
1.0.8 1,204 6/8/2022
1.0.7 1,964 5/13/2022
1.0.6 842 5/5/2022
1.0.5 3,911 4/8/2022
1.0.4 2,102 3/23/2022
1.0.3 1,971 3/9/2022
1.0.2 674 3/7/2022
1.0.1 658 3/7/2022
1.0.0 879 2/27/2022
1.0.0-alpha.14 210 2/24/2022
1.0.0-alpha.13 196 2/24/2022
1.0.0-alpha.12 201 2/24/2022
1.0.0-alpha.11 186 2/21/2022