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 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 (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 (3)

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

Repository Stars
The main repository for all the Code Maze guides
This repository contains Generic Repository implementation for Entity Framework Core
A sample app for my online course "Clean Architecture: Patterns, Practices, and Principles" in .NET Core
Version Downloads Last updated 25,763 1/27/2024 531 1/27/2024 1,468 1/27/2024 1,381,816 12/1/2022 1,307,803 5/29/2022 72,033 5/29/2022 418,778 1/25/2022 19,571 1/25/2022 528,015 3/12/2021 104,054 11/29/2020 275,103 11/29/2020 162,680 6/29/2020 79,724 2/26/2020 40,275 11/9/2019 9,387 10/6/2019 120,777 6/30/2020
2.2.1 159,028 2/1/2019
2.0.1 192,118 2/23/2018
1.0.0 8,150 10/13/2017

Added support for EntityFrameworkCore 8.0