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

Showing the top 4 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
A software to let your Tesla charge with solar energy ☀
Version Downloads Last updated 408,122 1/27/2024 8,304 1/27/2024 6,267 1/27/2024 1,971,260 12/1/2022 1,586,824 5/29/2022 103,201 5/29/2022 448,626 1/25/2022 31,688 1/25/2022 588,160 3/12/2021 110,384 11/29/2020 298,105 11/29/2020 167,274 6/29/2020 85,537 2/26/2020 41,368 11/9/2019 9,981 10/6/2019 129,573 6/30/2020
2.2.1 161,009 2/1/2019
2.0.1 194,151 2/23/2018
1.0.0 10,622 10/13/2017

Added support for EntityFrameworkCore 8.0