MongoDB.EntityFrameworkCore 8.2.0

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

// Install MongoDB.EntityFrameworkCore as a Cake Tool
#tool nuget:?package=MongoDB.EntityFrameworkCore&version=8.2.0                

MongoDB Entity Framework Core Provider

MongoDB.EntityFrameworkCore

The MongoDB EF Core Provider requires Entity Framework Core 8 on .NET 8 or later and a MongoDB database server 5.0 or later, preferably in a transaction-enabled configuration.

Getting Started

Setup a DbContext with your desired entities and configuration

internal class PlanetDbContext : DbContext
{
    public DbSet<Planet> Planets { get; init; }

    public static PlanetDbContext Create(IMongoDatabase database) =>
        new(new DbContextOptionsBuilder<PlanetDbContext>()
            .UseMongoDB(database.Client, database.DatabaseNamespace.DatabaseName)
            .Options);

    public PlanetDbContext(DbContextOptions options)
        : base(options)
    {
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);
        modelBuilder.Entity<Planet>().ToCollection("planets");
    }
}

To get going with the DbContext:

var mongoConnectionString = Environment.GetEnvironmentVariable("MONGODB_URI");
var mongoClient = new MongoClient(mongoConnectionString);
var db = PlanetDbContext.Create(mongoClient.GetDatabase("planets"));
db.Database.EnsureCreated();

Supported Features

Entity Framework Core and MongoDB have a wide variety of features. This provider supports a subset of the functionality available in both, specifically:

  • Querying with Where, Find, First, Single, OrderBy, ThenBy, Skip, Take etc.
  • Top-level aggregates of Any, Count, LongCount
  • Mapping properties to BSON elements using [Column] or [BsonElement] attributes or HasElementName("name") method
  • Mapping entities to collections using [Table("name")] attribute or ToCollection("name") method
  • Single or composite keys of standard types including string, Guid and ObjectId
  • Properties with typical CLR types (int, string, Guid, decimal, DateOnly etc.) & MongoDB types (ObjectId, Decimal128)
  • Properties of Dictionary<string, ...> type
  • Properties containing arrays and lists of simple CLR types
  • Owned entities (aka value types, sub-documents, embedded documents) both directly and within collections
  • BsonIgnore, BsonId, BsonDateTimeOptions, BsonElement, BsonRepresentation and BsonRequired support
  • Value converters using HasConversion
  • Query and update logging including MQL (sensitive mode only)
  • Some mapping configuration options for DateTime
  • EnsureCreated & EnsureDeleted operations
  • Optimistic concurrency support through IsConcurrencyToken/ConcurrencyCheckAttribute & IsRowVersion/TimestampAttribute
  • AutoTransactional SaveChanges & SaveChangesAsync - all changes committed or rolled-back together
  • CamcelCaseElementNameConvention for helping map Pascal-cased C# properties to came-cased BSON elements
  • Type discriminators including OfType<T> and Where(e => e is T)

Limitations

A number of Entity Framework Core features are not currently supported but planned for future release. If you require use of these facilities in the mean-time consider using the existing MongoDB C# Driver's LINQ provider which supports them.

Planned for upcoming releases

  • Select projections with client-side operations
  • Sum, Average, Min, Max etc. support at top level

Not supported but considering for future releases

  • ExecuteUpdate & ExecuteDelete
  • Binary/byte array properties
  • Additional CLR types (DateOnly, TimeOnly etc).
  • EF shadow properties
  • GroupBy operations
  • Relationships between entities
  • Includes/joins
  • Foreign keys and navigation traversal

Not supported & out-of-scope features

  • Keyless entity types
  • Schema migrations
  • Database-first & model-first
  • Alternate keys
  • Document (table) splitting
  • Temporal tables
  • Spacial data
  • Timeseries
  • Atlas search

Breaking changes

This project's version-numbers are aligned with Entity Framework Core and as-such we can not use the semver convention of constraining breaking changes solely to major version numbers. Please keep an eye on our Breaking Changes document before upgrading to a new version of this provider.

Documentation

Questions/Bug Reports

If you’ve identified a security vulnerability in a driver or any other MongoDB project, please report it according to the instructions here.

Contributing

Please see our guidelines for contributing to the driver.

Thank you to everyone who has contributed to this project.

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

NuGet packages (7)

Showing the top 5 NuGet packages that depend on MongoDB.EntityFrameworkCore:

Package Downloads
ShayganTadbir.Framework.Core

Package description

eQuantic.Core.Data.EntityFramework.MongoDb

Core Data library for Entity Framework and Mongo DB

NewDawnApiLibrary

Package Description

TbdDevelop.Kafka.Outbox.MongoDb

Package Description

ThingsLibrary.Database.Mongo

This is the shared foundational library

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on MongoDB.EntityFrameworkCore:

Repository Stars
thisisnabi/Shortener
Shortener Url as a service in ASP.NET Core and Actor Model
thisisnabi/Notify
Notify as a service in ASP.NET Core & VSA
Version Downloads Last updated
8.2.0 7,783 10/28/2024
8.1.1 33,977 9/10/2024
8.1.0 25,129 8/15/2024
8.0.3 41,182 6/28/2024
8.0.2 8,293 6/19/2024
8.0.1 33,293 5/13/2024
8.0.0 13,297 4/30/2024
7.0.0-preview.1 48,204 10/11/2023