Field Extensions

EntityGraphQL provides field extension methods for modifying you field expressions with common use cases, such as paging collections.

The following highlights the provided field extensions in EntityGraphQL available as well as an introduction to creating your own.

• UseFilter to add expression based filtering to collections
• UseSort to add a sort argument to your collections
• Paging
  • UseConnectionPaging for paging collections
  • UseOffsetPaging for paging collections
• UseAggregate to expose aggregate data (count plus min/max/sum/average) over collections
• Creating your own Field Extensions

When combining multiple extensions together on a single field order matters. The correct order is for the provided extensions is

Filter -> Sort -> Paging -> Aggregate

UseAggregate goes last because by default it adapts to the shape produced by the extensions before it: if the field is paged it attaches an aggregate field to the paging result, otherwise it wraps the field as { items, aggregate }. An additive, non-breaking sibling {field}Aggregate field is also available as an opt-in. See UseAggregate for the placement options.