Enum EagerLoadMode

Namespace

NextORM.Core

Assembly

nextorm.core.dll

Selects how the collections declared with LoadWith are loaded. The mode belongs to the whole builder: an explicit value applies to every declared collection, including those declared before it, while Default inherits the current choice.

public enum EagerLoadMode

Extension Methods

EntityBuilderExtensions.AsEntityBuilder<T>(object?)

Fields

Auto = 4

Automatic strategy selection. Resolved once during preparation by the conservative E1 rule, which selects SplitQuery for every supported load; it never silently reinterprets a per-parent top-N or correlated request.

Correlated = 3

Correlated per-parent loading. Recognized but not supported in this release: a query that resolves to this mode is rejected with NotSupportedException before any SQL is generated or cached. The value is reserved for the correlated/per-parent top-N work tracked separately.

Default = 0

No explicit choice: inherit the builder's current mode, defaulting to split loading.

SingleQuery = 2

Single-query loading: one denormalized LEFT JOIN command stitched in memory.

SplitQuery = 1

Split loading (the default): the parent command plus one chunked child query per collection.