MadEyeMatt.MongoDB.DbContext 9.0.3

dotnet add package MadEyeMatt.MongoDB.DbContext --version 9.0.3                
NuGet\Install-Package MadEyeMatt.MongoDB.DbContext -Version 9.0.3                
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="MadEyeMatt.MongoDB.DbContext" Version="9.0.3" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MadEyeMatt.MongoDB.DbContext --version 9.0.3                
#r "nuget: MadEyeMatt.MongoDB.DbContext, 9.0.3"                
#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.
// Install MadEyeMatt.MongoDB.DbContext as a Cake Addin
#addin nuget:?package=MadEyeMatt.MongoDB.DbContext&version=9.0.3

// Install MadEyeMatt.MongoDB.DbContext as a Cake Tool
#tool nuget:?package=MadEyeMatt.MongoDB.DbContext&version=9.0.3                

MongoDB.DbContext

A DB context implementation for MongoDB.

The DB context implementation is very heavily inspired by the EntityFramework Core DbContext infrastructure. The options configuration works the same. The database options can be set when configuring the context, or agail later (and maybe altered) when new instances of the context are created.

The context services are registered as scoped automatically. Every context will get the MongoDB driver services (IMongoDatabase, IMongoClient) from an interner service provider which will have those services registered as singleton instances. This cache of internal service providers uses the conenction string, str database name and the context options type as key, so changing the database name for a context at runtime (by overriding OnConfiguring) will result in a new internal service provider with the corresponding MongoDB singleton services.

Usage

To add a MongoDbContext one uses the AddMongoDbContext extension method. There are several ways to configure one or multiple contexts.

Configuration without custom context class

To get started quickly, one can simply use the MongoDbContext class and configure the database by passing an options builder action to AddMongoDbContext. This way you have no possibility to further configure the context at runtime.

services.AddMongoDbContext<MongoDbContext>(builder =>
{
	builder.UseDatabase("mongodb://localhost:27017", "test");
});

Configuration with custom context class

If you need more control ove the context configuration or need to add multiple different contexts, you need to dervice you context class from MongoDbContext

services.AddMongoDbContext<SampleContext>(builder =>
{
	builder.UseDatabase("mongodb://localhost:27017", "test");
});
public sealed class SampleContext : MongoDbContext
{
	public SampleContext(MongoDbContextOptions options)
		: base(options)
	{
	}

	/// <inheritdoc />
	protected override void OnConfiguring(MongoDbContextOptionsBuilder builder)
	{
		builder.UseDatabase("mongodb://localhost:27017", "other");
	}
}

The OnConfiguring method is called everytime a new instance of the context is created, so it is possible to change the connection settings for the context based on runtime information.

Configuring multiple different context classes

If you need to add several contexts you need to inject the generic version of the MongoDbContextOptions to allow the correct options be created. There will be an exception thrown if you don't do it.

services.AddMongoDbContext<SampleContextOne>(builder =>
{
	builder.UseDatabase("mongodb://localhost:27017", "one");
});

services.AddMongoDbContext<SampleContextTwo>(builder =>
{
	builder.UseDatabase("mongodb://localhost:27017", "two");
});
public sealed class SampleContextOne : MongoDbContext
{
	public SampleContext(MongoDbContextOptions<SampleContextOne> options)
		: base(options)
	{
	}
}

public sealed class SampleContextTwo : MongoDbContext
{
	public SampleContext(MongoDbContextOptions<SampleContextTwo> options)
		: base(options)
	{
	}
}

Configuring telemetry information

To expose telemetry information via System.Diagnostics just enable it in the MongoDbContextOptions. If you like to integrate this telemetry into OpenTelemetry just add a source with the name MongoDB.Driver.Core.Extensions.DiagnosticSources.

services.AddMongoDbContext<SampleContext>(builder =>
{
	builder
		.UseDatabase("mongodb://localhost:27017", "test")
		.EnableTelemetry();
});

References

EntityFramework Core

MongoDB.Driver.Core.Extensions.DiagnosticSources

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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on MadEyeMatt.MongoDB.DbContext:

Package Downloads
Fluxera.Repository.MongoDB

A MongoDB repository implementation.

MadEyeMatt.AspNetCore.Identity.MongoDB

A libary that provides MongoDB UserStore and RoleStore implementations for ASP.NET Identity Core.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
9.0.3 82 12/17/2024
9.0.2 362 11/16/2024
9.0.1 123 11/14/2024
9.0.0 94 11/14/2024
8.1.5 201 11/1/2024
8.1.4 1,527 7/9/2024
8.1.3 595 5/23/2024
8.1.2 816 4/18/2024
8.1.1 510 3/19/2024
8.1.0 327 2/22/2024
8.0.1 768 1/4/2024
8.0.0 518 11/16/2023
7.2.2 165 11/12/2023
7.2.1 335 7/20/2023
7.2.0 472 4/25/2023
7.1.0 370 4/13/2023
7.0.2 239 4/13/2023
7.0.1 233 4/12/2023
7.0.0 190 4/12/2023