see on GitHub

Indexing LINQ Extensions

Various indexing LINQ extensions are available to enhance the usability and reduce the complexity of the indexing functions. The available extensions are:


You can read more about boosting here.


Strings and enumerables can be reversed by using Reverse extension.

public class Employees_ByReversedFirstName : AbstractIndexCreationTask<Employee>
	public Employees_ByReversedFirstName()
		Map = employees => from employee in employees
					select new
						FirstName = employee.FirstName.Reverse()
IList<Employee> results = session
	.Query<Employee, Employees_ByReversedFirstName>()
	.Where(x => x.FirstName == "treboR")


WhereEntityIs can be used to check if given Raven-Entity-Name value in metadata for the given document matches any of the given values. This can be useful when indexing polymorphic data. Please visit our dedicated article to get more information (or click here).


IfEntityIs is similar to WhereEntityIs, yet it checks only against one value.

Parsing numbers

String values can be safely parsed to int, long, decimal and double using the appropriate methods:

  • ParseInt,
  • ParseLong,
  • ParseDecimal,
  • ParseDouble

There are two overrides for each method: The first one returns the default value in case of parsing failure. The second one accepts the value that should be returned when failure occurs.

public class Item_Parse : AbstractIndexCreationTask<Item>
	public class Result
		public int MajorWithDefault { get; set; }

		public int MajorWithCustomDefault { get; set; }

	public Item_Parse()
		Map = items => from item in items
					let parts = item.Version.Split('.', StringSplitOptions.None)
					select new
						MajorWithDefault = parts[0].ParseInt(),			// will return default(int) in case of parsing failure
						MajorWithCustomDefault = parts[0].ParseInt(-1)	// will return -1 in case of parsing failure

public class Item
	public string Version { get; set; }
session.Store(new Item { Version = "3.0.1" });
session.Store(new Item { Version = "Unknown" });


var results = session
	.Query<Item_Parse.Result, Item_Parse>()

Assert.Equal(2, results.Count);
Assert.True(results.Any(x => x.MajorWithDefault == 3));
Assert.True(results.Any(x => x.MajorWithCustomDefault == 3));
Assert.True(results.Any(x => x.MajorWithDefault == 0));
Assert.True(results.Any(x => x.MajorWithCustomDefault == -1));