Enumeration Extension Methods

Check if all elements in a collection satisfy a specified condition.

persons.All(p => p.Age < 50)

This can be used on it's own and will return either true or false or as part of an IF statement

<<[persons.All(p => p.Age < 50)]>>

Or

<<if [persons.All(p => p.Age < 50)]>>Everyone is younger than 50. <</if>>

Persons.Any()

Checks if any element in a collection satisfies a specified condition. It returns true if at least one item matches the condition, or false if none do. 

persons.Any(p => p.Name == "John Smith")

Example:

<<if [persons.Any(p => p.Age > 30)]>>There is someone older than 30.<</if>>

Calculate the mean value of a numeric property across all items in. a collection.

persons.Average(p => p.Age)

persons.Concat(otherPersons)

Check if a key value or collection contains an item that matches a specified condition. 

persons.Contains(otherPersons.First())

-------------

Example template syntax

<<foreach [person in persons]>>
<<if [person.Name.Contains(“John”)]>>
<<[Name]>>
<</if>><</foreach>>

Example JSON:

{
"persons": [
   { "Name": "John Smith"},
   { "Name": "Alice Williams"},
   { "Name": "Bob Taylor"}
 ]
}

Word document result:

John Smith

Expanding on the example above you can change the syntax slightly to find everything that doesn't match the condition. 

<<foreach [person in persons]>>
<<if [!(person.Name.Contains(“John”))]>>
<<[Name]>>
<</if>><</foreach>>

Word document result:

Alice Williams
Bob Taylor 

Count the amount of elements in the array

persons.Count()

Example template syntax

<<[Persons.Count()]>>

Example JSON

{
"Persons": [
{"name": "Oakley", "age": 18},
{"name": "Carter", "age": 32},
{"name": "Declan", "age": 35},
{"name": "Brody", "age": 13}
]}

Result

4

Count the elements in an array fulfilling a criteria

persons.Count(p => p.Age > 30)

Example template syntax

<<[Persons.Count(p => p.age > 30)]>>

Example JSON

{
"Persons": [
{"name": "Oakley", "age": 18},
{"name": "Carter", "age": 32},
{"name": "Declan", "age": 35},
{"name": "Brody", "age": 13}
]}

Result

2

persons.Distinct()

Returns the element at the given location in the array

ElementAt()

Example template syntax

<<[(Numbers.ElementAt(2))["number"]]>>

Example JSON

{
"Numbers": [
{"number": 10},
{"number": 2},
{"number": 13},
{"number": 40}
 ]
}

Word document result:

13

persons.First()

persons.First(p => p.Age > 30)

persons.FirstOrDefault()

persons.FirstOrDefault(p => p.Age > 30)

Group items in a collection based on a specified property or key. 

persons.GroupBy(p => p.Age)

or

persons.GroupBy( p => new { Age = p.Age, Count = p.Children.Count() })

-------------

Example template syntax:

<<foreach [group in persons.GroupBy(p => p.City)]>>
City: <<[group.Key]>>
<<foreach [person in group]>>
Name: <<[person.Name]>>
<</foreach>>
<</foreach>>

Example JSON:

{
  "persons": [
    { "Name": "John", "City": "London" },
    { "Name": "Alice", "City": "New York" },
    { "Name": "Bob", "City": "London" }
  ]
}

Word document result:

City: London
Name: John
Name: Bob

City: New York
Name: Alice

persons.Last()

persons.Last(p => p.Age > 100)

persons.LastOrDefault()

persons.LastOrDefault(p => p.Age > 100)

persons.Max(p => p.Age)

persons.Min(p => p.Age)

persons.OrderBy(p => p.Age)

Or

persons.OrderBy(p => p.Age).ThenByDescending(p => p.Name)

persons.OrderByDescending(p => p.Age)

Or

persons.OrderByDescending(p => p.Age).ThenByDescending(p => p.Name)

persons.Select(p => p.Name)

persons.SelectMany(p => p.Children)

persons.Single()

persons.Single(p => p.Name == "John Smith")

persons.SingleOrDefault()

persons.SingleOrDefault(p => p.Name == "John Smith")

persons.Skip(10)

persons.SkipWhile(p => p.Age < 21)

persons.Sum(p => p.Children.Count())

persons.Take(5)

persons.TakeWhile(p => p.Age < 50)

persons.Union(otherPersons)

persons.Where(p => p.Age > 18)