NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →

NuGet · #687 most downloaded on NuGet

NHibernate

5.7.083M downloads/mofredericDelaporte/nhibernate-core ↗New releases in your daily digest, changelog included.

NHibernate is a mature, open source object-relational mapper for the .NET framework. It is actively developed, fully featured and used in thousands of successful projects.

Last release 16 days ago
22 Sep 2026
Release timing varies
gaps range from 2 weeks to 1.1 years
Nearly every release is documented
notes for 58 of the last 60 stable releases
17 versions withdrawn
withdrawn after publishing
127 years old
102 releases · first in 1900

Release timeline

102 releases since 1900

Releases

5.7.030 Jun 20262 sources agree
Release notes - NHibernate - Version 5.7.0
Release notes - NHibernate - Version 5.7.0

** Highlights * NHibernate targets now directly include .NET 10. This new target come with changes to adapt to the "first-class span types" C# 14 language feature which was breaking some NHibernate features. * 14 issues were resolved in this release.

##### Possible Breaking Changes ##### * The NHibernate features using binary serialization will now throw a SerializationException for applications targeting .NET 10 or greater. These features can be restored by configuring a serialization strategy with your own custom strategy. (See Cfg.Environment.SerializationStrategy or set NHibernate.Util.SerializationConfiguration.Strategy.) See #3745.

** Bug

#3716 Update query with new expression crashes in visual basic

#3725 DbBatchBatcher may fail on empty batch execution

** New Feature

#3715 Enable use of Testcontainers

#3712 Add DateOnly and TimeOnly support

** Improvement

#3651 Support for "first-class span types" C# 14 language feature

#3742 Refactor Command parts to avoid duplicate characters. Reduces memory footprint

#3745 Add pluggable serialization strategy and make BinaryFormatter opt-in

** Task

#3758 Release 5.7.0

#3722 Use global.json dotnet version for actions

#3749 Update actions/checkout action to v6

#3750 Update GitHub Artifact Actions (major)

#3753 Merge 5.6.1 into master

#3754 Switch macos-13 tests to macos-26-intel

** Tests

#3662 Run tests using .NET 10
Open source →

5.6.07 Oct 20252 sources agree

Release notes - NHibernate - Version 5.6.0

Release notes - NHibernate - Version 5.6.0

##### Possible Breaking Changes #####
    * A thread synchronization timeout may now occur in case of transaction scope timeout, throwing
      an additional exception. The additional throw can be disabled through the new setting
      `transaction.ignore_session_synchronization_failures`. See #3355.
    * The default value of `transaction.system_completion_lock_timeout` has been lowered from 5000
      (5 seconds) to 1000 (1 second). See #3355.
    * Binary serializations of a session factory or a session from previous versions of NHibernate
      will not be deserializable with NHibernate 5.6.
    * Oracle9iDialect now registers localtimestamp as current_timestamp, instead of systimestamp.
      See #3707.

76 issues were resolved in this release.

** Bug

#3707 Register localtimestamp as current_timestamp in Oracle9iDialect
#3643 Collection cache lookup failure with enum keys
#3631 Missing version update on dirty collection with another property having optimistic-lock false
#3622 ISession.Refresh does not update lazy properties
#3618 ISQLQuery.ExecuteUpdate produces an exception in certain cases
#3602 Unable to implement custom tuplizer due to internal constructor
#3557 Fix configuration order in tests
#3546 Fix incorrect import in DynamicClassFixture
#3525 Querying Seconds on DateTime(Offset) can cause issues in e.g PostgreSQL
#3523 ScaleDefined is not set by SqlType ctor
#3519 Fix reference errors in XML comments
#3518 Add workaround for Rider to see the Antlr3 generated files at design time
#3498 collection [CollectionKey[]] not located in load context
#3480 Fix null reference exception when running tests with Npgsql 8
#3474 Unwanted implied commits may occur for Oracle and MySql
#3464 Remove duplicate entry in dialects documentation
#3424 Exception when using Future to load an entity with no-lazy children
#3421 Empty dynamic components cause phantom updates
#3355 InvalidOperationException on SequencedHashMap.OrderedEnumerator.MoveNext

** New Feature

#3624 Add SybaseASE16Dialect with LIMIT and OFFSET pagination support
#3559 Add new DB2NetDriver and obsolete DB2CoreDriver
#3556 Add support for .NET 8 Math functions
#3461 Support for DbBatch

** Improvement

#3703 Guidelines for handling breaking changes
#3687 Relax collection-id mapping
#3682 InternalsVisibleTo NHibernate.Test
#3676 When referencing a composite-id in Linq, the fkey table is wrongly joined
#3657 Allow thread safe usage of SessionFactoryObjectFactory
#3649 Improve some sparse arrays
#3640 Some string.Intern's for minimizing duplicate strings count
#3610 Eliminate memory allocations in GuidCombGenerator under .NET 8+
#3513 Int32Type: avoid unnecessary boxing for common cases
#3486 LinkedHashMap creates enormous amount of memory traffic
#3475 Adjust the doc about flush on commit
#3473 The sql type of the CultureInfoType is too short
#854 NH-1284 - Initialization of nullable structs component

** Task

#3706 Update actions/setup-dotnet action to v5
#3705 Enable skip_branch_with_pr: true for appveyor
#3702 Configure backports with Mergify
#3701 Update dependency gitreleasemanager.tool to v0.20.0
#3696 Release 5.6.0
#3694 Merge 5.5.3 into master
#3690 Update actions/checkout action to v5
#3689 Update Microsoft.Data.SqlClient to v5
#3619 Update dependency gitreleasemanager.tool to 0.18.0
#3612 Update dependency log4net to v3
#3596 Migrate renovate config
#3594 Update dependency NUnit3TestAdapter to 4.6.0
#3593 Update dependency NUnit.Console to v3.18.1
#3590 Remove Microsoft.SourceLink.GitHub
#3581 Update dependency NUnit.Analyzers to v4.2.0
#3580 Update dependency log4net to v2.0.17
#3579 Merge 5.5.2 into master
#3574 Remove usage of NHIBERNATE_BOT_TOKEN
#3570 Fixing a typo in PersistEvent.cs
#3562 Migrate .NET Core PostgreSQL Windows tests from AppVeyor to GitHub Actions
#3561 Migrate .NET Core SQLite Windows tests from AppVeyor to GitHub Actions
#3555 Obsolete IValue SetTypeUsingReflection & associated methods
#3553 Obsolete ForeignKeys.IsNotTransientSlow
#3552 Cache zero values to reduce boxing in PrimitiveType.DefaultValue
#3549 Obsolete NullableType.Get by column name
#3543 Obsolete JoinedEnumerable
#3542 Add a security policy
#3533 Update Iesi.Collections to 4.1.1
#3532 Remove mentions of Prevalence cache from documentation
#3522 Fix NUnit2050 warnings
#3521 Update dependency NUnit.Analyzers to v4.1.0
#3510 Merge 5.5.1 into master
#3501 Update dependency NUnit.Console to v3.17.0
#3494 Add .NET 8.0 target
#3492 Add NUnit analyzers
#3484 Modernize the test case example
#3479 Update actions/setup-dotnet action to v4
#3477 Update dependency NSubstitute to v5.1.0
#3372 Update dependency gitreleasemanager.tool to v0.17.0

** Tests

#3309 Test Case for Invalid SQL with property-ref on property using a formula

Open source →

5.5.024 Dec 20232 sources agree

Release notes - NHibernate - Version 5.5.0

Release notes - NHibernate - Version 5.5.0

##### Possible Breaking Changes #####
    * `Object.Finalize` is no more proxified when the entity base class has a destructor. See #3205.
    * Default not-found behavior now works correctly on many-to-many Criteria fetch. It now throws
      ObjectNotFoundException exception for not found records. See #2687.

62 issues were resolved in this release.

** Bug

#3413 Downgrade dependency System.Data.SQLite.Core 1.0.118 -> 1.0.117
#3406 Fix orphan removal for detached one-to-one
#3392 Partial fix fetching lazy property after Select in Linq
#3360 Incorrect parameter length for char types in MicrosoftDataSqlClientDriver
#3334 Exception executing HQL query with uncorrelated left joins in subselect
#3327 HqlParser does not correctly negate EXISTS-nodes below an AND/OR
#3325 Cascading orphan delete may not work on versioned entity
#3311 NamedQuery ignores <query-param type="AnsiString"> and any other
#3264 Fix collection filter on subclass columns
#3256 Invalid SQL is generated for string Enum used in conditional LINQ
#3205 Object.Finalize should not be proxiable
#2687 Use table group joins for many-to-many in Criteria and Entity loaders
#1267 NH-3047 - Lazy=no-proxy ignores join fetch

** New Feature

#3242 Linq: add enum Equals and object Equals support
#3165 Add support for Firebird 4
#829 NH-3365 - Support for HasFlag method for enums with Flags attribute applied

** Improvement

#3429 Explicit how to use advanced Redis strategies
#3410 Remove redundant collection BeforeAssemble call from query cache
#3398 Do not store mapping field in Configuration
#3396 Get rid of select queries for each ManyToMany not found ignored element in Criteria and lazy loading
#3395 Remove ConstantConverter
#3394 Get rid of select queries for each ManyToMany not found ignored element in hql
#3390 Enable Not node handling in HqlParser.NegateNode
#3384 Improve path rule handling with reserved words in Hql.g
#3377 Move HqlToken.PossibleId to HqlParser.IsPossibleId method and remove castings
#3374 Simplify aggregateDistinctAll rule in Hql.g
#3373 Refactor sequential select related members in AbstractEntityPersister
#3341 Apply fromFragment processing only when required in ProcessDynamicFilterParameters
#3340 SqlString.Trim should return the same instance for not modified string
#3253 Do not throw for unknown type in hql case node
#3230 Add cached boxed boolean values to BooleanType
#3209 Allow custom query loader

** Task

#3460 Merge 5.4.7 in master
#3445 Release 5.5.0
#3440 Update NUnit to v3.14.0
#3423 Update actions/checkout action to v4
#3420 Merge 5.4.6 in master
#3411 Remove ISessionFactoryImplementor parameter from TableGroupJoinHelper
#3409 Merge 5.4.5 in master
#3387 Merge 5.4.4 in master
#3379 Remove NHibernate.Example.Web project
#3362 Update dependency NUnit3TestAdapter to v4.5.0
#3361 Update dependency NUnit.Console to v3.16.3
#3353 Migrate renovate config
#3351 Merge 5.4.3 in master
#3284 Update NHibernate.Caches to v5.9.0
#3283 Update dependency NSubstitute to v5
#3280 Add tests for Microsoft.Data.SqlClient driver
#3275 Migrate dev packages to Cloudsmith
#3241 Exclude generated files from Deepsource analisys
#3236 Add MySQL8Dialect and MySQL8InnoDBDialect
#3223 Simplify GitHub Actions Tests DB initialization
#3206 Update actions/setup-dotnet action to v3
#3202 Update dependency Npgsql to v7
#3129 [Security] Update Oracle.ManagedDataAccess
#3122 Update dependency FirebirdSql.Data.FirebirdClient to v9
#3102 Update dependency Microsoft.Data.SqlClient to v3.1.3
#3099 [Security] Update dependency System.Linq.Dynamic.Core to v1.3.3
#3098 Update dependency System.Data.SQLite.Core to v1.0.118
#3092 Update dependency Microsoft.AspNetCore.OData to v7.7.0
#3088 Update NUnit to v3.13.3

** Tests

#3412 Revive hql ParsingFixture

Open source →

5.4.020 Nov 20222 sources agree

Release notes - NHibernate - Version 5.4.0

Release notes - NHibernate - Version 5.4.0

** Highlights * NHibernate has gained three new target frameworks: .Net 6, .Net Framework 4.8 and .Net Standard 2.1. NHibernate NuGet package provides them, along with the older targets, .Net Core 2.0, .Net Framework 4.6.1 and .Net Standard 2.0. These new targets allow some NHibernate optimizations for applications using them. The same limitations apply for .Net 6 and .Net Standard 2.1 as for .Net Core 2.0 and .Net Standard 2.0, see NHibernate 5.1.0 release notes. * A new batching strategy is available, minimizing the batching memory footprint. See #2959. Using it may increase CPU usage. * 201 issues were resolved in this release.

##### Possible Breaking Changes #####
    * One-to-one changes does now trigger a version increment, consistently with the default behavior of other kinds of
      associations. See #3204.
    * Linq and criteria queries on unmapped entities will throw instead of returning an empty result list. See #1106, #1095.
    * The second level cache UpdateTimestampsCache does not use locks anymore. This may slightly increase the number of cases
      where stale data is returned by the query cache. See #2742.
    * Equality and hashcode access on uninitialized persistent collections will no more trigger their loading. See #2461.
    * DB2CoreDriver now uses named parameters instead of positional ones. See #2546.

** Bug

#3198 EntityUpdateAction increments version despite veto on update
#3189 Support proxies of classes with init properties
#3188 No way of detecting if AutoFlush performed in added AutoFlushEventListener
#3176 Cached entity always fetches lazy properties with read-write concurrency strategy
#3156 Evaluation failure when using Nullable without a value in LINQ
#3150 LINQ query dynamic component by interface hangs the application
#3109 Fix table group join issue with subclasses
#3104 Inner Join fails with left Outer Join when referenced in Where clause
#3076 Nested group by results in "A recognition error occured"
#2968 Fix QueryStatistics.ExecutionAvgTime calculation
#2827 Fix BadImageFormatException in dynamic proxies for abstract classes and interfaces
#2822 "A recognition error ocurred" querying by a nullable component with more than N properties
#2758 Fix AmbiguousMatchException in ClearPool with FirebirdClient 6.6.0 and above
#2750 Using System.Transaction with IStatelessSession doesn't always flush batches to database
#2738 Unused Left Join in LINQ throws exception
#2717 MappingByCode discriminator column with string type throws exception
#2675 Fix collection lazy loading with composite keys on subclass columns
#2672 Linq query failure with left joins
#2619 InvalidOperationException in ProxyGenerator for class with generic non-virtual method
#2614 Obvious bug in two HQLQueryPlan classes with distinction Set
#2594 Wrong SQL produced by DML LINQ when using a select clause for a property referencing the outer select
#2555 Add spaces around concat operator
#2552 One-to-one second level cache issue
#2548 Mark DB2Dialect as not supporting null columns in unique constraint
#2547 Fix paging in DB2Dialect
#2540 Unable to use external predicate in subquery
#2534 Fix asymmetrical SqlType.Equals
#2454 ConditionalProjection containing the correlation to outer query fails to determine projection type
#2330 join on multiple conditions
#2201 Fetch Join generates incorrect SQL joins for the same entity type
#2092 Projection and join fetch in hql leads to duplicated column aliases
#1365 NH-3288 - Stale data checking does not work for one-to-one associations
#1349 NH-3893 - HQL parse error of a query with 'left' or 'right' function
#1326 NH-3622 - Fetching in query causes incorrect/missing joins in subquery
#1316 NH-3530 - memory when using default_batch_fetch_size
#1235 NH-2785 - StaleStateExceptions discarded on optional <join> table
#1215 NH-2208 - Error with filters on joined-subclass as many-to-one
#1209 NH-2049 - Error with filters on joined-subclass as one-to-one
#1180 NH-3847 - ConditionalProjection throws "Both true and false projections must return the same types" when the types are the same
#1106 NH-2978 - LINQ: Queries for unmapped entity types return empty result set
#1075 NH-2239 - Wrong OrderBy in generated SQL when using ICriteria, Eager fetching and order by clauses in collection mappings
#1072 NH-2174 - Invalid SQL is generated for OneToMany collections
#1062 NH-1893 - Trigger-Identity with Dynamic Insert throws ORA-01036 (10g)

** New Feature

#2959 Support Dynamic BatchFetchStyle
#2744 Set which entities classes should never be cached, even indirectly
#2737 Add more left join support
#2645 Allow specifying the size of the query plan cache
#2641 Avoid InvalidCastException with Oracle number high precision values
#2551 Add support for joining a subquery in hql
#2545 Table group joins for subclasses in Criteria
#2486 Add Projections.Select in Criteria
#2361 Table group joins support in hql

** Improvement

#3184 Support caching queries with autodiscovered types
#3177 Disable default caching in tests
#3160 Allow internal entity classess/interfaces in .NET Standard 2.0
#3133 Automatically generate async code on pull request
#3127 Register IType CLR types as aliases
#3116 Simplify SqlGenerator.FromFragmentSeparator
#3114 Exclude generated async files from Deepsource analysis
#3106 Skip table group join processing for implicit join
#3091 Use GitReleaseManager dotnet tool
#3083 Update SHFB in order to build documentation without MSBuild
#3050 Add .NET Standard 2.1 target
#3027 Avoid allocations on lock in SyncCacheLock
#3000 Add .NET 6 and .NET Framework 4.8 targets
#2990 Use inner join instead of implicit join for implied entity joins
#2957 Avoid lambda compilation as much as possible
#2948 Avoid lambda compilation for member access expressions in LINQ
#2947 LINQ queries triggers JIT a bit too much
#2920 Add parameter type to ADO exception
#2804 Projections.Conditional for CASE expressions with multiple conditions
#2752 Change cascade style for DefaultDirtyCheckEventListener to persist to avoid flushing the session
#2742 Remove locks from UpdateTimestampsCache
#2723 Avoid double param type guessing and better NULL parameter handling in LINQ
#2706 Set the rolledBack flag when disposing active transactions
#2700 Potential improvement to AliasToBeanResultTransformer
#2621 Regression bug with enums used as parameter for string column
#2571 Default value for CancellationToken in IQueryBatch.GetResultAsync
#2568 Support internal entity classes by proxy factory
#2556 Register right function for Firebird and PostgreSQL
#2546 Enable named parameters on DB2CoreDriver
#2539 Skip no longer needed moving ON condition to Where clause in LINQ
#2538 Remove no longer needed alias substitution for filtered many-to-many collection in hql
#2518 Support Aggregate subqueries with paging on MS SQL Server
#2510 Remove OrderByClause from query models with Contains, All and Any result operators
#2492 Replace casting with NodeType checks in Criteria ExpressionProcessor
#2479 When using a paged sub-query in Linq, generates incorrect SQL
#2461 Remove persistent collections Equals/GetHashCode overrides
#2460 Simplify single alias retrieval for SimpleProjections
#2448 Avoid lambda compilation for constant and member access expressions in Criteria
#1285 NH-3249 - Cannot perform HQL with "COUNT(DISTINCT Date(s.Date))"
#1244 NH-2868 - Generate method of ForeignGenerator fails with stateless sessions
#1095 NH-2829 - QueryOver/Criteria should throw exception when querying against unmapped class
#871 NH-3115 - Should de-duplicate joins when using fetching with where in LINQ query
#869 NH-2952 - Setting the SqlCheck is not supported in the ByCode mapping
#809 NH-2799 - Provide the CancelQuery() method in IStatelessSession
#766 NH-3813 - Eager fetch on key-many-to-one relation adds inner joins to the query
#715 NH-1040 - property-ref on joined-subclasses should work or error

** Task

#3197 Update dependency System.Data.SqlClient to v4.8.5
#3195 Release NHibernate 5.4
#3161 Tell NuGet about the readme file
#3147 Add datetimex keyword to SapSQLAnywhere17Dialect
#3146 Run tests against Oracle XE 21c
#3123 Update dependency Npgsql to v6
#3121 Update dependency Microsoft.NETFramework.ReferenceAssemblies to v1.0.3
#3119 Update actions/setup-dotnet action to v2
#3118 Update actions/checkout action to v3
#3117 Update dependency NSubstitute to v4.4.0
#3111 Update dependency log4net to v2.0.15
#3080 Replace Dependabot with Renovate
#3063 Bump Oracle.ManagedDataAccess from 19.12.0 to 21.6.1
#3061 Bump Oracle.ManagedDataAccess.Core from 2.19.120 to 3.21.61
#3059 Bump log4net from 2.0.12 to 2.0.14
#3057 Run tests using .NET 4.8
#3017 Add deepsource.io code analysis
#3002 Bump NUnit3TestAdapter from 4.1.0 to 4.2.1
#2987 Disable auto rebasing for depandabot PRs
#2951 Run tests on .NET 6
#2946 Bump Microsoft.SourceLink.GitHub from 1.0.0 to 1.1.1
#2936 Bump System.Data.SQLite.Core from 1.0.114.3 to 1.0.115.5
#2911 Bump System.Data.SqlClient from 4.8.2 to 4.8.3
#2898 Bump FirebirdSql.Data.FirebirdClient from 6.6.0 to 8.5.2
#2887 Bump Oracle.ManagedDataAccess from 19.11.0 to 19.12.0
#2886 Bump Oracle.ManagedDataAccess.Core from 2.19.110 to 2.19.120
#2878 Bump System.Linq.Dynamic.Core from 1.2.10 to 1.2.12
#2870 Bump MySql.Data from 8.0.25 to 8.0.26
#2851 Cache Dialect in tests
#2818 Bump Microsoft.Data.SqlClient from 2.1.3 to 3.0.0
#2800 Bump System.Data.SQLite.Core from 1.0.113.7 to 1.0.114.2
#2799 Bump Npgsql from 4.0.3 to 4.1.9
#2796 Bump System.Linq.Dynamic.Core from 1.2.9 to 1.2.10
#2790 Bump Microsoft.NET.Test.Sdk from 16.9.4 to 16.10.0
#2786 Bump Microsoft.Data.SqlClient from 2.1.2 to 2.1.3
#2771 Bump MySql.Data from 8.0.22 to 8.0.25
#2770 Bump System.Data.SQLite.Core from 1.0.109.2 to 1.0.113.7
#2765 Bump Microsoft.NETFramework.ReferenceAssemblies from 1.0.0 to 1.0.2
#2759 Enable dependabot
#2756 Update dependencies
#2607 Merge 5.3.5
#2605 Upgrade AsyncGenerator to 0.19.1
#2593 Merge 5.3.4
#2582 Remove no longer used code in QueryModelVisitor
#2570 Update Relinq and LinFu links
#2516 Suppress Codefactor single class per file rule for test project
#2501 Upgrade MySql client and remove allowed failures on CI builds

** Tests

#3024 Enable test accessing Component's Parent property in LINQ
#2921 Fix test for SAP SQL Anywhere
#2848 Add Oracle to GitHub Actions
#2541 LINQ SELECT tests with WHERE subquery
#2489 Improve CriteriaAssertFixture
#2456 Test case for #1180 and improve NullableType.ToString
#2242 Test case for NH-3972 - SQL error when selecting a column of a subclass when sibling classes have a column of the same name

Open source →

5.3.019 Jul 20202 sources agree

Release notes - NHibernate - Version 5.3.0

Release notes - NHibernate - Version 5.3.0

220 issues were resolved in this release.

##### Possible Breaking Changes #####
    * A distributed cache may hold conflicting timestamps after upgrade for as much as twelve hours.
      Consider flushing a distributed cache after upgrade to avoid any issue. Do not share a distributed
      cache with applications using an earlier version of NHibernate.
    * The counter id generator may generate conflicting ids for as much as twelve hours after upgrade.
    * `update` and `delete` statements will now take into account any enabled filter on the entities
      they update or delete, while previously they were ignoring them. (`insert` statements will also take
      them into account, but previously they were failing instead of ignoring enabled filters.)
    * ISession.Persist and ISession.Merge will no more trigger immediate generation of identifier.
    * Bags will no more be loaded with "null" entities, they will be filtered out.
    * Setting the value of an uninitialized lazy property will no more trigger loading of all the lazy
      properties of the entity.
    * If an uninitialized lazy property has got its value set, without any other subsequent lazy property
      load on the entity, a dynamic update will occur on flush, even if the entity has dynamic updates
      disabled. This update will occur even if the set value is identical to the currently persisted
      property value.
    * Assigning an uninitialized proxy to a `no-proxy` property will no more trigger the proxy
      initialization. Moreover, reading the property afterwards will no more unwrap the assigned proxy,
      but will yield it.
    * A class having an explicitly implemented interface declaring a member with the same name than the
      class id will have its proxies trigger a lazy load if the interface "id" is accessed.
    * SQLite: in order to avoid a floating point division bug losing the fractional part, decimal are now
      stored as `REAL` instead of `NUMERIC`. Both are binary floating point types, excepted that `NUMERIC`
      stores integral values as `INTEGER`. This change may cause big integral decimal values to lose more
      precision in SQLite.
    * SQLite: non supported SQL type names previously used by NHibernate, resulting in unexpected actual typing,
      have been fixed. This causes databases generated by a previous NHibernate version to fail schema validation
      by 5.3 or higher versions. See #2507 for more information.
    * Custom dialects used for databases that do not support cross join will have to override
      `SupportsCrossJoin` property and set it to `false`.
    * `VisitorParameters.ConstantToParameterMap` may contain the same parameter for multiple constant
      expressions.
    * `ICache` caches yielded by the session factory will be `CacheBase` wrappers around the cache actually
      provided by the cache provider, if it was not deriving from `CacheBase`.
    * Calling `IList.RemoveAt` or `IList<>.RemoveAt` on an uninitialized list with a negative number
      will now throw an `ArgumentOutOfRangeException`.
    * Calling `IList.RemoveAt` or `IList<>.RemoveAt` on an uninitialized list mapped as `lazy="extra"`
      with a number that is equal or higher that the current collection size will now throw an
      `ArgumentOutOfRangeException`.
    * Calling `IList.Insert` or `IList<>.Insert` on an uninitialized list with a negative number will
      now throw an `ArgumentOutOfRangeException`.
    * Calling `IList.Insert` or `IList<>.Insert` on an uninitialized list mapped as `lazy="extra"`
      with a number that is higher that the current collection size will now throw an 
      `ArgumentOutOfRangeException`.
    * Getting or setting a value with `IList.this[int index]` or `IList<>.this[int index]` on an uninitialized
      list with a negative number will now throw an `ArgumentOutOfRangeException`.
    * Setting a value with `IList.this[int index]` or `IList<>.this[int index]` on an uninitialized list
      mapped as `lazy="extra"` with a number that is equal or higher that the current collection size will now
      throw an `ArgumentOutOfRangeException`.
    * Calling `IDictionary<,>.Add` or `ICollection<>.Add` on an uninitialized map mapped as `lazy="extra"` with
      a key that already exists will now throw an `ArgumentException`.
    * Calling `IDictionary<,>.Remove` or `ICollection<>.Remove` on an uninitialized map mapped as `lazy="extra"`
      with a key that does not exist will now return false.
    * Map dirtiness is now evaluated by `EqualityComparer<TValue>.Default` when setting an existing key value
      with `IDictionary<,>.this[]` on an initialized map.
    * Calling `ISet<>.Add` on an uninitialized set mapped as `lazy="extra"` with a transient element that
      already exists in the set will now return false.
    * Calling `ISet<>.Add` or `ICollection<>.Add` on an uninitialized set mapped as `lazy="true"` with a
      transient element that does not override `Equals` method will not initialize the collection.
    * Linq custom generators deriving from `BaseHqlGeneratorForMethod` should override the
      `TryGetCollectionParameter` method if they have to support parameter lists.

** Bug

#2425 NRE with nullable subselect value in Linq
#2421 Chapter 26: Best Practices, error about identifier recommendations
#2410 Second level cache failures with CoreMemoryCaches
#2380 OData NotSupportedException MemberInit on base class member
#2365 Add Linq parameter type detection
#2346 Fix SQLite typing
#2336 Intermittent null reference exception on CloseConnection
#2324 Update IIsEntityDecider to use ExpressionsHelper.TryGetMappedType
#2319 Upgrade AsyncGenerator to 0.18.1
#2299 Proper query plan caching for DML LINQ queries
#2286 Wrong sql if used joined-subclass with filters for key columns
#2278 IInterceptor.OnPrepareStatement results not used in insert/update commands
#2266 Fix comment for Restrictions.IsEmpty
#2255 Fix a flaky test
#2245 Add sqlite.binaryguid to configuration schema
#2244 SelectMany Linq extension does not work correctly - subsequent FetchMany fails
#2233 Fix possible issue with async code for delayed entity inserts
#2231 Invalid alias name used in Linq Joins
#2222 NHibernate query plan for Linq Dml is not cached
#2219 Fix BuildTool output path
#2215 Fix ShowBuildMenu.sh
#2181 Skip null entities when bag is populated
#2164 Do not call GC.SuppressFinalize from finalizer thread
#2158 Proper support for IN clause for composite values in Criteria
#2147 Improve async locking
#2144 AdoTransaction memory leak (5.2.5)
#2137 NullReferenceException in EntityEntry.GetLoadedValue on an update of a never loaded detached entity
#2099 "Composite Index" not working with inheritance
#2088 Fix cacheable CreateSQLQuery throws on query with AddJoin
#2085 Duplicated methods generated in proxies
#2067 Wrong proxy built for base class with interfaced sub-classes
#2064 One-to-one properties not appearing in Select() projection result set
#2053 Dml Style Update fails with static where sql in mapping
#2038 Fix a typo on the memcached distributed cache description in the docs
#2029 Incorrect SQL for cast inside an aggregate (MS SQL)
#2019 Update symbol package format and add Sourcelink
#2000 Fixed Equals method for transformers
#1997 Fix criteria collection ordering
#1994 Extra Select for every "outfiltered" Element
#1993 InvalidCastException when merging a collection with a lazy property
#1985 DateTime.xxxx are not supported in SelectGroup
#1965 Fix code sample in docs, section 10.4.2
#1956 Fix lazy property caching
#1921 DML insert fails when a filter is enabled
#1738 Refresh of locally removed collection item crashes with "instance was not in a valid state"
#1480 Fix cache build for honoring mapped concurrency
#1368 NH-3778 - Crash when performing a Linq query on a one-to-one mapped reference
#1341 NH-3848 - Child collection fetched using left outer join with on clause or where clause restrictions on fetched collection shouldn’t be stored in second level cache.
#1319 NH-3549 - BasicFormatter throws exceptions for certain types of data containing "signal words"
#1312 NH-3493 - Cannot use alias between more than 1 level of nested queries
#1310 NH-3478 - StatefulPersistenceContext.RemoveEntity KeyNotFoundException on Evict
#1309 NH-3469 - Impossible to load one-to-one association with LINQ for composite-id
#1274 NH-3117 - Query on one-to-one property returns incorrect results
#1263 NH-2991 - Criteria withClause doesn't work in case of many to many collections
#1228 NH-2648 - HQL with joins in sub-select creates wrong SQL
#1206 NH-1761 - Criteria query inserts an extra order by expression when using JoinType.LeftOuterJoin and Projections
#1158 NH-3492 - SqlClientBatchingBatcher incorrectly ignoring per-SessionFactory Settings properties
#1128 NH-3210 - NHibernate Linq Provider does cross join or left outer join and not inner join (even if outer-join=false on many-to-one mapping)
#1124 NH-3155 - Linq subquery with group is not supported
#1125 NH-3178 - Exception when using one-to-one properties in a criteria projections
#1117 NH-3079 - Cannot use a sql custom loader with a composite ID
#1107 NH-2983 - Coalesce in projection doesn't work if there is more than 1 Coalesce
#1103 NH-2926 - CriteriaQuery - Unable to sort by composite-id
#1100 NH-2892 - The <key /> columns containing reserved words are not quoted
#1059 NH-1001 - Select statement issued for each not-found=ignore
#1047 NH-3865 - Swallowed ArgumentNullException with dynamic composite id
#1015 NH-2951 - Missing alias in hql update (select) statement with joined subclasses
#1006 NH-2714 - Properties mapped inside a <properties> group are not set when retrieving object

** New Feature

#2411 Add an option to register a custom pre-transformer for a Linq query
#2392 Add locate support for SQLite
#2362 Add support for lt, gt, le, ge oData operators on strings
#2349 Add support for Oracle binary floating point types
#2347 Support fetching individual lazy properties for Criteria EntityProjection
#2327 Add cross join support for Hql and Linq query provider
#2313 Add overloads to ISession.Get taking both an entityName and a lockMode
#2259 Schema auto-update should throw errors
#2221 Support MemberInit expression in group by
#2216 Add a driver to support Microsoft.Data.SqlClient provider
#2209 IN clause support in hql for composite keys on databases without row value constructor support
#2156 Support basic arithmetic operations (+, -, *, /) in QueryOver
#2135 Support OData GroupBy/Aggregate
#2116 Ability to replace ConfigurationManager with a custom config provider
#2108 Multi-Tenancy: Implement tenant per Database strategy
#2107 Port Hibernate's Aggregate functions for subqueries
#2106 Port Hibernate's support subqueries in HQL as CASE statement alternatives
#2100 Allow to override default types with length or precision parameters
#2097 Add support for fetching an individual lazy property with Criteria
#2090 Add support for caching fetched relations with Criteria
#2080 Add ability to set custom collection type as a string in mapping by code
#2049 Fix property-ref ignoring not-found="exception" mapping
#1949 Port Hibernate's lazy attribute fetch groups
#1922 Add support for fetching an individual lazy property with hql and linq provider
#1861 Lazy loading and Eager initialization for Component
#1376 Composite id is incorrectly expanded in SQL
#1195 NH-4078 - LINQ fetched collections aren't cached
#981 NH-3873 - Explicit joins on unrelated classes
#959 NH-4048 - Support non-deterministic/db-side-only methods in Linq
#896 NH-1432 - Expression.Sql should support aliases other than {alias}

** Improvement

#2404 Allow overriding default CastFunction
#2401 Optimize JoinWalker.WhereString method
#2399 Optimize PersistentGenericBag.EqualsSnapshot
#2394 Optimize PersistentGenericSet snapshot
#2352 Improve performance of ReflectHelper.GetMethod/Definition
#2350 Optimize LINQ batch item processing for queries with overridden result type
#2316 Add multiple arguments support for ISQLFunction
#2315 Add SetFlushMode for QueryOver and Linq
#2295 Optimize filter applying logic
#2287 Allow customizing 'alias to bean' property not found behavior
#2284 Make persistent collection classes implement the IReadOnly* interfaces
#2270 IQueryOver<T> is lacking some options
#2254 Add dev build version suffix
#2249 Improve handling of SqlCeParameter.SqlDbType
#2248 Remove most RemoveAsAliasesFromSql usages
#2241 Avoid duplicating parameters in LINQ query
#2238 Call generic query.List from Linq queries
#2235 Configure log4net from embedded resource log4net.xml in tests
#2232 Use SqlStringBuilder for batching Future/QueryBatch queries
#2226 Use DateTime.UtcNow for timestamps
#2225 Avoid unnecessary locking via MethodImplOptions.Synchronized
#2223 Short-Circuit SessionFactoryImpl.Close() when already closed
#2214 Allow configuring auto-join transaction globally
#2213 Add a shortcut to reduce Transaction.Current reads
#2211 Port SupportsRowValueConstructorSyntaxInInList values
#2182 Upgrade AsyncGenerator to 0.17.1
#2166 Optimize usages of SqlString.Append
#2163 Add virtual DefaultQueryProvider.CreateWithOptions
#2162 Use collection types for private members
#2161 Optimize ToArray conversions
#2159 Unify handling of composite values in hql and Criteria
#2153 Use generic parameters in ActionQueue
#2139 Add ability to set fetch for <one-to-one> mapping in mapping by code
#2131 Create Stopwatch only if stats is enabled
#2126 Upgrade AsyncGenerator to 0.14.0
#2125 Skip logger default initialization logic when logger provided by user
#2123 Use Assert.Throws instead of try-catch in tests
#2119 Obsolete interfaces for Loquacios configuration and use config classes directly
#2117 Replace array concatenation with hand written append
#2115 Statefull Session commit performance issue when nothing changed and second level cache with query cache enabled
#2091 Obsolete StringHelper.Join
#2084 Improve one-to-one handling in queries
#2082 Use entities prepared by Loader in hql select projections
#2078 Avoid unnecessary join for entity comparisons in with clause
#2071 Support subclass mapping with EntityName based base class mapping
#2061 Reduce cast usage for COUNT aggregate and add support for Mssql count_big
#2058 DB2 dialect enhancements
#2056 Optimize GetOrphans and remove wrong checks from IsNotTransientSlow
#2041 Hql entity join fixes
#2039 Use generic CollectingNodeVisitor in hql parser
#2036 Reduce cast usage for aggregate functions
#2032 Allow using ON instead of WITH in hql
#2024 Refactor to simplify netfx retargeting
#2022 Make CancellationToken optional for async Linq DML queries
#2010 Add new collection operation queue mechanism
#2009 Add support for IDictionary<string, object> to IQuery.SetProperties
#2007 Dispose session in cascade tests
#2006 Skip Topological sorting if not required
#2003 Avoid some cases of Type -> string -> Type conversion in Mapping By Code
#2002 Refactor DependentAlias handling logic in JoinWalker
#1999 Optimize DistinctRootEntityResultTransformer
#1989 Optimize ProxyCacheEntry equality for the same instance
#1988 Improve exception on user types lacking some interfaces
#1984 Reduce SessionIdLoggingContext creation
#1981 Remove AbstractLazyInitializer unused field
#1979 Refactor sequential select
#1977 Obsolete IDeserializationCallback from EntityKey
#1972 Port Hibernate's EntityKey optimization
#1968 Optimize StaticProxyFactory GetProxy and GetFieldInterceptionProxy methods
#1955 Optimize batchable cache calls for cached queries
#1947 Partially port Hibernate's current field interceptor mechanism
#1946 Port Hibernate's BytecodeEnhancementMetadata
#1944 Extend IAccessOptimizer to support getting/setting single property value
#1943 Skip initialization of lazy properties when setting one
#1923 Obsolete StringHelper.Replace
#1860 LINQ "==" operator generates OR with IS NULL
#1754 Delay entity insert on Persist until session is flushed
#1627 Refactored session List<T> method for Criteria
#913 NH-3704 - Allow Setting Dynamic Component Templates From Dictionary
#864 NH-2379 - Add support of Left Joins to Linq Provider
#803 NH-2521 - Session.EnableFilter method should work for HQL-DML statement
#780 NH-1200 - Exception occurs when using criteria exist queries
#767 NH-3892 - Add ability to coalesce using a property instead of a constant
#722 NH-1953 - Support Future for collection filters
#476 Eliminated double Persister resolution in Loader.InstanceNotYetLoaded flow

** Task

#2433 Improve slightly mapping documentation
#2432 Document the caches configuration providers
#2430 Document cache.serializer setting of CoreDistributedCache
#2397 Update GitReleaseManager
#2391 Use latest Firebird for AppVeyor and Travis
#2388 Release 5.3
#2382 Refactor debug logging in AbstractBatcher
#2381 Use optimized Dictionary.Remove(key, out value) in .NET Core
#2379 Simplify swap items logic in LINQ Visitors
#2377 Use dotnet to push packages to nuget
#2376 Add MyGet gallery link to readme
#2368 Replace SafetyEnumerable<T> with OfType<T> where applicable
#2363 Upgrade AsyncGenerator to 0.18.2
#2356 Obsolete IdentitySet class
#2354 Do not require Mono to build on not Windows
#2353 Update Microsoft.SourceLink.GitHub to 1.0.0
#2351 Get rid of JoinedEnumerable<T> and SingletonEnumerable<T>
#2348 Use static ReferenceComparer for reference comparisons
#2308 Merge 5.2.7
#2294 Add StackExchangeRedis cache provider documentation
#2293 Update RtMemoryCache framework dependency
#2265 Fix code style issues
#2251 Publish development nightly builds on nuget
#2205 Merge 5.2.6
#2171 Upgrade NUnit
#2122 Update AsyncGenerator to 0.13.3
#2016 Avoid recursive calls in BatchFetchQueue
#2014 Obsolete Environment.Properties
#1973 Investigate licenseUrl deprecation
#1971 Add SourceLink to allow NuGet package debugging
#1940 Allow to provide dev specific properties in NHibernate.dev.props
#1936 Upgrade AsyncGenerator to 0.13.1

** Tests

#2384 Tests to verify NH-2329 is obsolete
#2360 Add OData test for single property $expand
#2089 Bidirectional list fails if session only knows about child
#2066 Tests for proxy interface handling
#1966 Test duplicated join on some Linq queries

Open source →

5.2.41 Mar 2019Breaking2 sources agree

As part of releasing 5.2.4, a missing 5.2.0 possible breaking change has been added about property-ref on null values. See 5.2.0 possible breaking cha…

Release notes - NHibernate - Version 5.2.4

3 issues were resolved in this release. The dialect change has the side effect of re-enabling a hack used by NHibernate.Spatial, allowing Spatial users to upgrade to NHibernate 5.2.x. See NHibernate.Spatial#104.

##### Possible Breaking Changes #####
    * Using DML on an entity collection was applying the changes without
      filtering according to the entity. It will now throw a
      NotSupportedException.

** Bug

#2020 Throw for DML on filter
#2011 Use a statically resolved dialect when building the session factory

** Task

#2030 Release 5.2.4

As part of releasing 5.2.4, a missing 5.2.0 possible breaking change has been added about property-ref on null values. See 5.2.0 possible breaking changes.

Open source →

5.2.03 Dec 20182 sources agree

Release notes - NHibernate - Version 5.2.0

Release notes - NHibernate - Version 5.2.0

157 issues were resolved in this release.

##### Possible Breaking Changes #####
    * Entities having many non-readonly properties (including many-to-one) mapped to
      the same column will no more silently ignore the trouble till an insert or update
      is attempted. They will now cause the session factory built to fail. When
      mapping many properties to the same column, all of them excepted at most one
      should be mapped with `insert="false" update="false"`.
    * Mappings mixing column elements and formula elements were taking into account
      only the formula elements. They will now take into account all elements.
    * Mappings mixing column elements and/or formula elements with a column attribute
      or a formula attribute were silently ignoring the attribute. They will now throw.
    * Mappings mixing a column attribute and a formula attribute were silently doing
      some best effort logic, either considering this as a two columns mapping, the
      second one being the formula (most cases), or only taking into account the
      formula (case of the `<element>` mapping). They will now throw.
    * NHibernate StringType has gained case-sensitivity and culture parameters.
      Previously it was ignoring parameters. This type may change its behavior
      for any mapping having defined parameters for this type. See #1833.
    * Mapping a dynamic component with a Hashtable property instead of an
      IDictionary is no more supported.
    * Querying a dynamic entity as a Hashtable instead of an IDictionary is no more
      supported.
    * A collection mapped with a `property-ref` will no more support being accessed
      when the referenced property is null. It will throw. Previously, the collection
      was not throwing but was always loaded empty.
    * With PostgreSQL, a HQL query using the bitwise xor operator "^" or "bxor"
      was exponentiating the arguments instead. It will now correctly apply the xor
      operator. (# operator in PostgreSQL SQL.)
    * Auto-generated constraint names will not be the same than the ones generated
      with previous NHibernate versions under .Net Framework. (Under .Net Core those
      names were anyway changing at each run.) The new ones will be the same
      whatever the runtime used for generating them.
    * Some generated PK names may change, if a table name has a quoting symbol at
      precise 13th character.
    * The WcfOperationSessionContext has been removed from .Net Core and .Net
      Standard builds. See #1842.
    * Some classes, which were not serializing the session factory, do now serialize it.
      In case of cross-process serialization/deserialization, these session factories
      will need to be properly named, by setting the session_factory_name setting in the
      configuration used to build them. This may mainly affect users of a distributed
      second level cache, if their cache implementation uses binary serialization.
      Affected classes are: CacheKey, CollectionKey, EntityKey and EntityUniqueKey.
    * Some types cache representations have changed. Out-of-process second level
      caches should be cleared after upgrading NHibernate, if some of those types
      were cached. The concerned types are: CultureInfoType, TypeType, UriType,
      XDocType, XmlDocType.
    * Dialect.GetIdentitySelectString was called by the entity persisters with
      inverted parameter values: the table name in the column parameter, and the
      column name in the table parameter. No built-in dialects were using the
      parameter values. External dialects which were using it inverted (causing issues
      to collection persisters, which have always supplied them correctly) needs
      to be accordingly adjusted.
    * Users providing through an IObjectFactory some custom logic for instantiating
      value types will now need to supply their own result transformer if they were
      using AliasToBeanResultTransformer with value types, or their own entity
      tuplizer if they were using value types as entities.
    * Users providing through an IObjectFactory some custom logic for instantiating
      their custom session contexts will have to implement
      ICurrentSessionContextWithFactory and add a parameterless public constructor
      to their custom context, and move their custom instantiation logic from
      IObjectsFactory.CreateInstance(Type, object[]) to
      IObjectsFactory.CreateInstance(Type).
    * Various *Binding classes of NHibernate will now always have their protected
      dialect field null. (These classes are not expected to be derived by users,
      as there is no way to use custom descendants with NHibernate.)
    * AbstractPersistentCollection.AfterInitialize does no more perform queued
      operations. Queued operations are now run by a later call to a new method,
      ApplyPendingOperations. Concrete custom implementations relying on the queued
      operations to be done by their base AfterInitialize will need to be changed
      accordingly.

** Bug

#1900 Do not generate FK on non-generated unique constraint
#1888 Second level cache key mismatch
#1886 Superfluous SQL casts generated in FirebirdClientDriver
#1885 Process classes accordingly to inheritance path in mapping by code
#1884 Fix attempt of static proxies to call base method for abstract classes
#1874 Item in child collection not being removed
#1872 Fix property ref handling
#1870 Update build-menu options in documentation
#1867 Fix registration of current_date for some dialects
#1859 Fix filter & where fragment appended after lock hint
#1855 Fix NotNullUnique not taken into account for single column
#1849 Loquatious QueryCache constraint should be an IQueryCacheFactory constraint
#1836 Cannot create configuration due to log4net loading failure
#1824 property-ref on a component's property causes "wrong number of columns" error
#1821 Allow using ICompositeUserType for collection element mappings in Mapping By Code
#1818 Handle DbDataReaders that do not support GetSchemaTable
#1812 Fix the <any/> handling without meta-values
#1809 Update the mapping documentation
#1799 Default value of 'proxyfactory.factory_class' in the documentation
#1774 HQL and LINQ query by the type on with meta-type "string" fails
#1769 Table mapping for UniqueColumn uses unstable GetHashCode() method
#1764 Fix configuration schema forbidding custom bytecode provider
#1760 Support formula on one-to-many map-key
#1756 Fix unsaved-value for assigned identifiers
#1753 Fix possible InvalidCastException in ActionQueue
#1751 Avoid completing the same transaction twice
#1748 Fix a bad setting naming about transaction scopes
#1745 Remove obsoleted hibernate configuration prefix
#1744 Reconnect lazy property proxy on deserialization
#1737 Remove a binary breaking change introduced in #305
#1728 Generate a correct proxy for interfaces
#1727 Fix a null-ref exception with no-proxy one-to-one
#1726 Fix serialization exception when run on .NET Core 2.1
#1719 Cascade delete-orphan on no-proxy null association fails
#1706 Entity Projection: Fixed AsEntity() for root entity
#1704 GroupBy to custom class fails with ArgumentException
#1696 Fixed CriteriaImpl.Clone for readonly query
#1692 Update base_mapping.xml
#1673 Bitwise xor treated as pow with PostgreSQL
#1654 Fix the url to the quickstart of DocBook
#1635 IdentitySelectString implementation is inconsistent
#1612 Fix TypedValue not always using adequate comparer with SetParameterList
#1609 Schema validation using SQLite and a specific schema fails
#1366 NH-3506 - ICriteria/QueryOver create incorrect left join condition when table-per-hierarchy is used with filters
#1358 NH-3992 - Intermediate inherited classes are not mapped correctly
#1344 NH-3864 - Cacheable Multicriteria/Future'd query with aliased join throw exception
#1339 NH-3823 - Initialization of Set with Lazy=Extra causes pending additions to disappear
#1338 NH-3806 - Saving entities with proxy associations leads to fetching associated entities
#1300 NH-3403 - Wrong parameter size in query with MsSql2000Dialect,MsSql2005Dialect and MsSql2008Dialect
#1293 NH-3350 - Duplicate records using Future()
#1278 NH-3189 - IManyToOneMapper lacks method to add columns AND formula into a single relationship
#1214 NH-2180 - Many-To-Many with Property-ref fails to get subitems with FetchMode Join
#1201 NH-1316 - PostgreSQL dialect use of lastval to retrieve last inserted "id" not safe with Triggers
#1182 NH-3860 - Missing EntityName in IManyToOneMapper
#1170 NH-3646 - Incorrect query when items removed from a collection of components contain null values
#1163 NH-3545 - SchemaValidator fails for PostgreSql sequences
#1151 NH-3426 - Wrong result when converting Guid to string
#1121 NH-3095 - Cast from mapped long field to enum leads to 'Specified cast not valid'
#1096 NH-2836 - SchemaValidator throws with SqlCe4 if db-schema set
#1089 NH-2755 - LockMode hash differs in x86 and 64bit OS
#1037 NH-3749 - Unnecessary comma in CREATE TABLE statement
#1016 NH-3007 - Informix dialect generates incorrect boolean constants
#1000 NH-2558 - NoViableAltException with boolean expression in OrderBy clause
#990 NH-2016 - Duplicate Association Path when creating multiple aliases
#460 Fix Criteria caching filtered collections

** New Feature

#1892 Allow disabling Firebird driver parameter casting
#1879 LINQ Coalesce and Conditional on Properties
#1854 Add SQL Anywhere 17 support
#1848 Add in ByCode support of all type mappings on Id
#1833 Parametrize string type comparer
#1830 Add a Linux build menu
#1796 Support CacheMode in QueryBatch
#1786 Document future results
#1772 Support futures with stateless session
#1752 Async ISynchronization
#1742 Add new DB2CoreDriver to use with IBM.Data.DB2.Core provider
#1693 Implement SurrogateSelector
#1690 Bitwise xor not supported by SQLite
#1682 Add support for System.MathF methods
#1662 Add support for SAP HANA
#1633 Added support for batching 2nd level cache operations when loading entities and collections
#1631 Create UtcTicks and UtcDbTimestamp types
#1599 Full control of entities fetching in Criteria
#1381 NHibernate's IQuery is missing AddSynchronizedQuerySpace
#968 NH-2285 - Support for LockMode in linq provider
#920 NH-3991 - Support for Sybase ASE ADO.NET 4 Provider
#897 NH-2187 - ElementAt LINQ extension method is not supported.
#838 NH-3805 - Add support for string indexer property (get_Chars)
#819 NH-3088 - Support the item operator [] on lists in linq queries

** Improvement

#1908 Control over BeginTransaction in AdoTransaction
#1905 Improve support of Npgsql 4
#1901 Add ability to use dynamic entities as C# dynamic
#1890 Merge two logs in one
#1875 Improve exception message in case of duplicated column
#1869 Replace an O(n) lookup in LINQ query parsing by an O(1) one
#1846 Remove dependency on System.Security.Permissions package for .NET Standard and .NET Core
#1842 Remove WcfOperationSessionContext from .Net Core and .Net Standard
#1838 Cannot add HqlJoin to HqlFrom
#1827 Include the query in loader PostInstantiate QueryException
#1819 Append the batched sql statement when StaleStateException occurs
#1814 Mark proxy assembly with IgnoresAccessChecksToAttribute to allow implementing non public interfaces
#1808 Support mixed formulas and columns
#1792 Obsolete HolderInstantiator
#1788 Implement multiple get and put for query cache and query batch
#1785 Update user types documentation
#1782 Refactor BugTestCase
#1781 Clean-up IObjectsFactory usages
#1778 Allow to use dynamic objects as dynamic components
#1777 Replace ICache interface by a CacheBase class
#1776 Make cache types serialization friendly
#1775 Start/Stop required db-service for TeamCity
#1770 Make obsolete abstract virtual
#1767 Allow generic dictionaries for dynamic entities
#1765 Provide cacheable representations for all NHibernate built-in types
#1762 Remove duplicated and obsolete interceptor documentation
#1761 Update mapping documentation
#1759 Support mixed formulas and columns in By Code
#1736 Remove excessive rowIdAlias parameter in Loader
#1713 Update contributing guidelines
#1712 Support IEquatable in LINQ provider
#1710 Rationalize DateTimeOffset read and write
#1709 Lazy properties static proxy
#1703 Remove dialect instantiation in AddDeserializedMapping
#1700 Single place to specify TargetFrameworks
#1699 Add ability to load types from in-memory-only assemblies
#1698 Document setting the logger factory programmatically
#1694 Implement CollectionHelper.GetHashCode that accepts IEqualityComparer
#1689 Purge more Invariant culture usages
#1671 Decouple configuration of IObjectsFactory from BytecodeProvider
#1666 Handle multi-queries support in FutureBatch
#1656 Allow any cache.* property in NHibernate configuration
#1641 Add cross platform build for full .NET Framework
#1452 Async After-/BeforeTransactionCompletion
#874 NH-3543 - Enhanced Db2 driver to support multi query
#865 NH-2428 - Session.MultiCriteria and FlushMode.Auto inside transaction
#840 NH-3835 - Future/MultiCriteria 2nd level caching
#822 NH-3150 - Select Post Insert Generator Improvements
#755 NH-3670 - Dynamic component should allow generic dictionary
#752 NH-3541 - Future queries of Criteria API/QueryOver are batched separately from other query methods
#696 Upgrade to ReLinq 2.2.0
#415 Add check to ensure that IUserCollectionType.Instantiate returns uninitialized collection

** Task

#1863 Release 5.2.0
#1823 Run tests for SQLite on .NET Core
#1783 Obsolete MultiQuery and MultiCriteria
#1773 Obsolete unused version related methods of SByteType
#1771 Obsolete unused "xml" type methods
#1743 Merge 5.1.3 into master
#1739 Upgrade to AsyncGenerator 0.8.2.7
#1688 Merge 5.1.2 into master
#1687 Update NUnit to 3.10.1
#881 NH-3358 - Document all attributes for the element tag

** Tests

#1887 Test ref and out methods with static proxy
#1724 NH-2716 - Modify test case for discarding the alleged bug
#1584 Test Parent property is not accessible in queries
#1531 Test for Merging a bidirectional list creates unnecessary UPDATE statement
#1440 Test case for ComposedId Entity with Lazy Property is not proxified
#1414 Test ISession.IsDirty() should not trigger cascade saving

As part of releasing 5.2.0, a misnamed setting in 5.0.0 release notes has been fixed: transaction.use_connection_on_system_events correct name is transaction.use_connection_on_system_prepare

Open source →

5.1.524 Mar 20192 sources agree

Release notes - NHibernate - Version 5.1.5

Release notes - NHibernate - Version 5.1.5

##### Possible Breaking Changes #####
    * Using DML on an entity collection was applying the changes without
      filtering according to the entity. It will now throw a
      NotSupportedException.

** Bug

#2043 System.Reflection.TargetException when an interface is used as class mapping proxy definition
#2020 Throw for DML on filter

** Task

#2074 Release 5.1.5

Open source →

5.1.017 Mar 2018Breaking2 sources agree

As part of releasing 5.1.0, a missing 5.0.0 possible breaking change has been added about inequality semantic in LINQ queries. See 5.0.0 possible brea…

Release notes - NHibernate - Version 5.1.0

** Highlights * NHibernate has gained two new target frameworks: .Net Core 2.0 and .Net Standard 2.0. NHibernate NuGet package provides them, along with the .Net framework 4.6.1 build. For these new frameworks, some additional specificities or limitations apply: * Binary serialization is not supported - the user shall implement serialization surrogates for System.Type, FieldInfo, PropertyInfo, MethodInfo, ConstructorInfo, Delegate, etc. * SqlClient, Odbc, Oledb drivers are converted to ReflectionBasedDriver to avoid the extra dependencies. * CallSessionContext uses a static AsyncLocal field to mimic the CallContext behavior. * System transactions (transaction scopes) are untested, due to the lack of data providers supporting them. * 114 issues were resolved in this release.

##### Possible Breaking Changes #####
    * Since Ingres9Dialect is now supporting sequences, the enhanced-sequence identifier generator will default to
      using a sequence instead of a table. Revert to previous behavior by using its force_table_use parameter.
    * Some overridable methods of the Dialect base class and of MsSql2000Dialect have been obsoleted in favor of
      new methods. Dialects implementors need to override the replacing methods if they were overriding the
      obsolete ones, which are:
      * Dialect.GetIfNotExistsCreateConstraint(Table table, string name), replaced by
        GetIfNotExistsCreateConstraint(string catalog, string schema, string table, string name).
      * Dialect.GetIfNotExistsCreateConstraintEnd(Table table, string name), replaced by
        GetIfNotExistsCreateConstraintEnd(string catalog, string schema, string table, string name).
      * Dialect.GetIfExistsDropConstraint(Table table, string name), replaced by
        GetIfExistsDropConstraint(string catalog, string schema, string table, string name).
      * Dialect.GetIfExistsDropConstraintEnd(Table table, string name), replaced by
        GetIfExistsDropConstraintEnd(string catalog, string schema, string table, string name).
      * MsSql2000Dialect.GetSelectExistingObject(string name, Table table), replaced by
        GetSelectExistingObject(string catalog, string schema, string table, string name).

** Bug

#1606 NHibernate 5 precision maximum on decimal reduced vs. NHibernate 4
#1605 MySql batcher may attempt initiating a new batch without closing open reader first.
#1604 MySql batcher disables db exception translation
#1602 Preserve original snapshot mode.
#1594 AsyncLocal leak in SystemTransactionContext
#1587 Prevent substitute garbage collection
#1565 For update with outer join fails with PostgreSQL
#1562 Fix round registration
#1559 Deep removal of Fetch result operators when Any is used
#1556 Linq query with "Contains" on persistent collection fails
#1551 Assert for a null reference in a flaky test.
#1536 Avoid a null reference exception in ExpressionKeyVisitor
#1535 Fix some HQL functions registration
#1534 Fixed entity name retrieval for EntityProjection
#1526 ExpressionKeyVisitor does not produce unique keys for anonymous types coming from different assemblies
#1514 Fix exceptions serialization
#1511 Test Unicode string.
#1509 Add missing NHibernateLogLevel.Info in example web project
#1507 NH-3119 - fix test not supporting optimization
#1506 SQLite is bugged with distributed transactions: disable distributed tests
#1505 Chaining scopes with ODBC is bugged: disabling the test.
#1501 Fix NH-3023 test
#1496 Fix ManyToOneType.IsModified to handle both object instance and identifier passed to the parameter “old”.
#1491 Forgotten async generation for #1487
#1486 Fix IsModified so that a null equates empty components when using select-before-update.
#1484 Fix default types
#1478 Exception when using envers with the latest logging changes
#1476 Fix GetQueryCache storing two different caches.
#1468 Comparison with DateTime? produces wrong SQL
#1463 Fix a null reference case in session context
#1454 Fix ProxyFactory cache
#1445 Upgrade AsyncGenerator to 0.6.2 and regenerate.
#1442 Unable to use an entity with a FieldInterceptor property and a lazy loaded property
#1436 StackOverflowException when merging an entity with a lazy property
#1434 Replace remaining SetOptions with WithOptions
#1385 SecondLevelCache CreateSQLQuery().UniqueResult<int>() throws Exception Specified cast is not valid.
#1372 NH-3982 - Simple query with Cacheable, Fetch and SingleOrDefault throws exception (regression from 3.3.0)
#1371 NH-3898 - Configuring a property with generated="insert" turns "Property.IsUpdatable" into"false" even using update="true" in the xml mapping file.
#1363 NH-2500 - NH 3.0 Linq provider uses query parameters from first call in subsequent calls.
#1335 NH-3787 - Decimal truncation in Linq ternary expression
#1330 NH-3673 - Closure variable values locked in from expressions in NHibernate LINQ provider
#1226 NH-2534 - Join-fetching a many-to-one with property-ref results in select n+1 problem
#1196 NH-4087 - Decimal truncation occurs after 5 digits
#1119 NH-3084 - Class NHibernate.Loader.Loader logs SQL statement on INFO level
#1052 NH-3976 - Inconsistent Decimal/NHibernateUtil.Currency handling causing runtime error when using Oracle.ManagedDataAccess
#987 NH-1509 - MsSql2000Dialect does not use default schema when creating "if exists" statement
#448 NH-1285 - Drop/Create script with default_schema/default_catalog fix(SqlServer)

** New Feature

#1588 Add a generic batcher for insert/update/delete statements, usable with PostgreSQL and others
#1545 Support to join not associated entities in Criteria (aka Entity Join)
#1451 New StaticProxyFactoryFactory
#1403 Add timeouts support to MultiCriteria
#1377 Logging refactoring
#954 NH-3807 - Support for .NET Core 2.0
#948 NH-3435 - Ability to select entities in Criteria projections
#910 NH-3606 - Open a stateless session from a session
#908 NH-3470 - Allow Linq Query to load entities as read-only

** Improvement

#1600 Set MySqlClientBatchingBatcher as a default batcher for MySqlDataDriver
#1597 Add support for single-argument truncate to dialects that do not support it natively
#1569 Modernize test example
#1567 Avoid Trim().Length as empty check and ToLowerInvariant() in string comparison
#1561 NAnt refactoring
#1558 Improved collection batch fetching
#1557 Aggregate named queries validation exceptions.
#1555 Catch practices: avoid losing catched exception information.
#1552 Obsolete UnmodifiableDictionary
#1549 Remove an override which was doing the same thing as the base
#1548 Add a missing short circuit in query parameter expansion.
#1547 Double query translation
#1546 Remove a redundant argument in Linq provider ExecuteQuery.
#1543 Various string manipulation optimizations
#1541 Cache subclass entity aliases in Loader
#1537 Avoid unnecessary persister lookup in Loader
#1529 Lazy mapping schema loading
#1521 Enable warning as error for all projects and configurations
#1519 Reuse SchemaExport in CreateSchema/DropSchema in tests
#1515 Make NHibernateUtil.Initialize / IsInitialized better reusable for sub-projects like Envers
#1504 More reliable SQLite handling in tests.
#1502 Upgrade Iesi to 4.0.3 in order to use a release assembly
#1498 Cease throwing bare Exception
#1494 Update to Oracle installation instructions.
#1490 Optimize empty arrays usages
#1483 Clean-up of TypeFactory
#1482 Refactored DefaultEntityAliases to avoid unnecessary calculations
#1477 Reuse the same generic EmptyMapClass instance across the project
#1475 Document expiration constraint on UpdateTimestampsCache region.
#1467 Reduce the number of calls to UpdateTimestampsCache
#1466 Obsolete EqualsHelper
#1465 Obsolete EnumerableExtensions
#1464 Obsolete ISessionImplementor.Initialize method
#1449 Document IsDirty potential side effects
#1441 Normalize TargetInvocationException unwrapping
#1417 Table counter for aliases should be stable
#1412 Store Linq query options in a query provider instead of a queryable
#1391 Performance regression in SessionIdLoggingContext
#843 NH-3879 - SequenceHiLoGenerator Jumps 1 number each lo > maxLo
#842 NH-3869 - Add a way of adding comments into LINQ queries
#837 NH-3804 - Register CHR/CHAR, NCHAR, UNICODE, and ASCII standard functions to the dialect(s)
#831 NH-3515 - Support for Decimal.Round, Decimal.Ceiling, Decimal.Floor and other static methods of Decimal class
#768 NH-3921 - Support sequences in Ingres9Dialect
#769 NH-3922 - The various timeout methods should indicate time unit

** Task

#1610 Move MsSql constants from driver to dialect.
#1608 Missing Async test for GH1594
#1603 Forgotten async generation of truncate test
#1598 Upgrade IESI to 4.0.4 for having a bumped file version.
#1589 Add framework info to example web project and enable .NET Core.
#1574 Fix encoding in NorthwindDbCreator.cs
#1563 Generate Async test for deep removal of fetch.
#1527 Adjust ignore rules for not ignoring DebugHelpers folder and contents
#1525 5.1.0 release
#1524 Reduce breaking changes due to Ingres9 sequence support
#1518 Upgrade to AsyncGenerator 0.8.1
#1512 Upgrade to NUnit 3.9
#1474 Upgrade AsyncGenerator to 0.7.0

** Tests

#1539 Add more tests for constants in LINQ queries

As part of releasing 5.1.0, a missing 5.0.0 possible breaking change has been added about inequality semantic in LINQ queries. See 5.0.0 possible breaking changes.

Open source →

5.0.724 Mar 20192 sources agree

Release notes - NHibernate - Version 5.0.7

Release notes - NHibernate - Version 5.0.7

##### Possible Breaking Changes #####
    * Using DML on an entity collection was applying the changes without
      filtering according to the entity. It will now throw a
      NotSupportedException.

** Bug

#2043 System.Reflection.TargetException when an interface is used as class mapping proxy definition
#2020 Throw for DML on filter

** Task

#2073 Release 5.0.7

Open source →