MongoGenericRepository 12.1.0

• .NETStandard 2.1

  • Microsoft.Extensions.Options (>= 10.0.11)
  • MongoDB.Driver (>= 3.11.0)

• net10.0

  • Microsoft.Extensions.Options (>= 10.0.11)
  • MongoDB.Driver (>= 3.11.0)

• net8.0

  • Microsoft.Extensions.Options (>= 10.0.11)
  • MongoDB.Driver (>= 3.11.0)

• net9.0

  • Microsoft.Extensions.Options (>= 10.0.11)
  • MongoDB.Driver (>= 3.11.0)

Serialization conventions are now configurable instead of having to be attributed on every entity class.

   Added:
   - MongoDbOptions.Serialization (MongoSerializationOptions) switches on the driver's IgnoreExtraElements and IgnoreIfNull conventions. The motivation is schema evolution: during a rolling update, instances running the newer schema write fields the older ones do not declare, which a strict driver turns into a FormatException. Both switches are independent bool? values and register nothing while unset, so an application that does not configure them keeps the behaviour of 12.0.0.
   - Namespaces and TypeFilter, combined by AND, limit the conventions to part of the type graph. Namespaces match whole segments: "MyApp.Orders" covers "MyApp.Orders.Archive" but not "MyApp.OrdersArchive". TypeFilter can only be set from code, as the configuration binder skips delegate properties. A Namespaces list that holds nothing usable is rejected rather than quietly covering every type.
   - MongoRepositoryConventions.Register applies the options explicitly and belongs at the start of application start-up; Unregister removes the pack again. Options are validated before the registry is touched, and ConventionPackName may not take over the driver's own pack names. Applications that never call Register get them from the first EntityContext constructed with options that ask for a convention.

   Worth knowing:
   - Conventions only reach class maps the driver builds afterwards, and a class map is built once per type and per process.
   - Attributes win over conventions: [BsonIgnoreExtraElements(false)] keeps an entity strict even while a tolerant convention is registered.
   - IgnoreIfNull changes the stored document, not only the read path: a null property is absent instead of stored as null, which $exists filters and sparse or partial indexes react to.

   See CHANGELOG.md for the full notes.