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

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


Build Status Downloads

This library helps you mocking EntityFramework contexts. Now you will be able to test methods that are using DbSet<TEntity> or DbQuery<TEntity> from DbContext in an effective way.

Installation - NuGet Packages

Install-Package Moq.EntityFrameworkCore


For example we can assume that we have the following production code:

public class UsersContext : DbContext
    public virtual DbSet<User> Users { get; set; }

To mock Users and Roles you only need to implement the following 3 steps:

1. Create DbContext mock:

var userContextMock = new Mock<UsersContext>();

2. Generate your entities:

IList<User> users = ...;

3. Setup DbSet or DbQuery property:

userContextMock.Setup(x => x.Users).ReturnsDbSet(users);


userContextMock.SetupGet(x => x.Users).ReturnsDbSet(users);


userContextMock.SetupSequence(x => x.Set<User>())
  .ReturnsDbSet(new List<User>())

And this is all. You can use your DbContext in your tests.

The second option is mocking DbSet that is part of the interface:

public interface IBlogContext
   DbSet<Post> Posts { get; }

And then use:

var posts = new List<Post>();
var contextMock = new Mock<IBlogContext>();
contextMock.Setup(p => p.Posts).ReturnsDbSet(posts);

You will find examples of this library in the repository.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Moq.EntityFrameworkCore:

Package Downloads

Package Description


Devocean.Tests is a set of base classes and helpers inteded to support implementing integration and unit tests on projects based on Devocean.Core


Package Description

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Moq.EntityFrameworkCore:

Repository Stars
The main repository for all the Code Maze guides
Version Downloads Last updated 633,849 12/1/2022 963,392 5/29/2022 44,955 5/29/2022 370,565 1/25/2022 7,081 1/25/2022 470,419 3/12/2021 96,728 11/29/2020 242,185 11/29/2020 158,019 6/29/2020 74,914 2/26/2020 38,558 11/9/2019 7,985 10/6/2019 111,865 6/30/2020
2.2.1 155,568 2/1/2019
2.0.1 189,746 2/23/2018
1.0.0 6,809 10/13/2017

Added support for EntityFrameworkCore 7.0