Genocs.Persistence.MongoDB 9.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.

Requires NuGet 5.0.0 or higher.

dotnet add package Genocs.Persistence.MongoDB --version 9.0.0
                    


                    

                
NuGet\Install-Package Genocs.Persistence.MongoDB -Version 9.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Genocs.Persistence.MongoDB" Version="9.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Genocs.Persistence.MongoDB" Version="9.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Genocs.Persistence.MongoDB" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Genocs.Persistence.MongoDB --version 9.0.0
                    


                    

                
#r "nuget: Genocs.Persistence.MongoDB, 9.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Genocs.Persistence.MongoDB@9.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Genocs.Persistence.MongoDB&version=9.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Genocs.Persistence.MongoDB&version=9.0.0
                    


                            Install as a Cake Tool

Genocs.Persistence.MongoDB

Genocs Library Banner

MongoDB repository and persistence integration for Genocs applications. Supports net10.0, net9.0, and net8.0.

Installation

dotnet add package Genocs.Persistence.MongoDB

Getting Started

Use this package to configure MongoDB repositories and persistence registrations for Genocs services.

Service registration:

using Genocs.Persistence.MongoDB.Extensions;

genocs.AddMongoWithRegistration();

Configuration example:

{
  "mongoDb": {
    "connectionString": "mongodb://localhost:27017",
    "database": "genocs_db",
    "guidRepresentationMode": "Standard"
  }
}

GUID Representation Strategy

Genocs.Persistence.MongoDB now defaults to GuidRepresentation.Standard for new deployments.

Available mongoDb.guidRepresentationMode values:

  • Standard (default)
  • CSharpLegacy (compatibility mode for legacy datasets)

Migration Guidance (Legacy GUID Data)

If your existing MongoDB data was written using legacy GUID representation:

  1. Set mongoDb.guidRepresentationMode to CSharpLegacy during transition.
  2. Validate read/write compatibility in staging against existing documents.
  3. Plan and execute GUID normalization/migration to standard representation.
  4. Switch mongoDb.guidRepresentationMode back to Standard once migration is complete.

Main Entry Points

  • AddMongo
  • AddMongoWithRegistration

Runtime Behavior Notes (April 2026)

  • IMongoDatabaseProvider, IMongoSessionFactory, and repository access paths now share one DI-managed IMongoClient composition.
  • Startup seeding is guarded per database key (connectionString|database), so different databases can seed independently in the same process.
  • If seeding fails, the initializer guard key is cleared so a subsequent startup can retry deterministically.

Encryption Surface Guidance

This package does not currently provide built-in client-side field encryption wiring.

If your application requires encryption-at-rest behavior at the driver layer:

  1. Implement encryption composition in application code.
  2. Keep the package registration focused on connectivity/repository concerns.
  3. Document and validate encryption behavior at host level.

Support

Release Notes

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Genocs.Persistence.MongoDB:

Package Downloads
Genocs.MessageBrokers.Outbox.MongoDB

The message brokers MongoDB outbox interface library useful to build .NET Core projects.
Genocs.Messaging.Outbox.MongoDB

MongoDB-backed implementation of the messaging outbox pattern.
Genocs.Saga.Integrations.MongoDB

MongoDB storage integration for Genocs saga state management.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
9.0.0 27 5/21/2026
9.0.0-beta009 136 5/11/2026
9.0.0-beta008 181 5/2/2026
9.0.0-beta007 110 4/29/2026
9.0.0-beta006 107 4/27/2026
9.0.0-beta005 122 4/26/2026
9.0.0-beta004 110 4/18/2026
9.0.0-beta003 161 4/5/2026
9.0.0-beta002 136 3/17/2026
9.0.0-beta001 151 2/28/2026
8.1.0 225 2/8/2026
8.0.0 2,762 11/23/2025
7.5.1 2,706 10/19/2025
7.5.0 5,408 10/12/2025
7.4.1 2,090 9/19/2025
7.4.0 341 9/19/2025
7.3.0 8,467 8/14/2025
7.2.5 13,780 5/1/2025
7.2.4 2,296 4/18/2025
7.2.3 17,417 1/20/2025
Loading failed

The change log and breaking changes are listed here.
           https://github.com/Genocs/genocs-library/releases