Class ODataQueryCompilation

Namespace

Utils.OData.Linq

Assembly

Utils.OData.dll

Represents the result of compiling a LINQ expression tree into an OData query.

public sealed class ODataQueryCompilation

Inheritance

object

ODataQueryCompilation

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

DataUtils.ToDbValue(object?)

MathEx.Clamp<T>(T, T, T, IComparer<T>)

FluentExtensions.Failure<T>(T)

FluentExtensions.IsEqualTo<T, CT>(T, CT)

FluentExtensions.IsGreaterOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsGreaterThan<T, CT>(T, CT)

FluentExtensions.IsIn<T>(T, params T[])

FluentExtensions.IsLowerOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsLowerThan<T, CT>(T, CT)

FluentExtensions.IsNotIn<T>(T, params T[])

FluentExtensions.IsNotNull<T>(T)

FluentExtensions.IsNull<T>(T)

FluentExtensions.Success<T>(T)

FluentExtensions.Test<T>(T, Func<T, bool>)

ObjectUtils.Between<T>(T, IComparer<T>, T, T)

ObjectUtils.Between<T>(T, IComparer<T>, T, T, bool, bool)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Func<Task<Result>>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Result)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.In<T>(T, params T[])

ObjectUtils.NotIn<T>(T, params T[])

Validations.ArgMustBe<T>(T, Func<T, bool>, string, string)

Validations.ArgMustNotBe<T>(T, Func<T, bool>, string, string)

Validations.Arg<T>(T, string)

Validations.ValueMustNotBeNull<T>(T, string)

Validations.Variable<T>(T, string)

Remarks

Item 36: this compilation model deliberately captures only $filter (from Where) and $expand (from navigation-property expansion). It intentionally does not model ordering, projection, $skip, $top, $count, $search, aggregation, or terminal operators. Those options must be applied through IQuery/ ODataQueryBuilder when issuing the request, or with LINQ-to-Objects after the data has been materialised. The public promise is narrowed to filter/expand compilation rather than advertising broader LINQ support that the model cannot honour.

Constructors

ODataQueryCompilation(string, IReadOnlyList<string>, IReadOnlyList<string>?)

Initializes a new instance of the ODataQueryCompilation class.

public ODataQueryCompilation(string entitySetName, IReadOnlyList<string> filters, IReadOnlyList<string>? expansions = null)

Parameters

entitySetName string

The name of the entity set targeted by the query.

filters IReadOnlyList<string>

The set of filter expressions applied to the query.

expansions IReadOnlyList<string>

The collection of navigation properties expanded by the query.

Exceptions

ArgumentException

Thrown when entitySetName is null or whitespace.

ArgumentNullException

Thrown when filters is null.

Properties

EntitySetName

Gets the name of the entity set targeted by the query.

public string EntitySetName { get; }

Property Value

string

Expansions

Gets the collection of navigation properties expanded by the query.

public IReadOnlyList<string> Expansions { get; }

Property Value

IReadOnlyList<string>

Filters

Gets the sequence of filter expressions applied to the query.

public IReadOnlyList<string> Filters { get; }

Property Value

IReadOnlyList<string>

Methods

ToUriString()

Builds the URI fragment that corresponds to the compiled query.

public string ToUriString()

Returns

string

The entity set name with appended OData query options when required.

Remarks

Item 26: query option values are percent-encoded so that characters such as spaces, ampersands, plus signs, and hash marks cannot corrupt the query-string boundary. The entity set name is used as a path segment and is not encoded here; callers that append this string to a base URI must ensure the overall URL is well-formed.