Microsoft.EntityFrameworkCore 9.0.2

Prefix Reserved

Requires NuGet 3.6 or higher.

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

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

Entity Framework Core (EF Core) is a modern object-database mapper that lets you build a clean, portable, and high-level data access layer with .NET (C#) across a variety of databases, including SQL Server (on-premises and Azure), SQLite, MySQL, PostgreSQL, Oracle, and Azure Cosmos DB. It supports LINQ queries, change tracking, updates, and schema migrations.

Getting started

Prerequisites

Make sure to install the same version of all EF Core packages shipped by Microsoft. For example, if version 5.0.3 of Microsoft.EntityFrameworkCore.SqlServer is installed, then all other Microsoft.EntityFrameworkCore.* packages must also be at 5.0.3.

Usage

To use Microsoft.EntityFrameworkCore in your application, you will typically need to create a class that inherits from DbContext, which represents your database session. You can then define classes that represent your database entities, and use LINQ queries to interact with the database.

Here's an example of how you might define a database context and an entity:

using Microsoft.EntityFrameworkCore;

public class MyDbContext : DbContext
{
    public DbSet<Customer> Customers { get; set; }
}

public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

You can then use the MyDbContext class to interact with the database:

using var context = new MyDbContext();

// Add a new customer
context.Customers.Add(new Customer { Name = "John Doe" });
context.SaveChanges();

// Retrieve all customers
var customers = context.Customers.ToList();

Microsoft.EntityFrameworkCore supports multiple database providers, including SQL Server, MySQL, PostgreSQL, SQLite, and others. You will need to install the provider package for your chosen database. For example, to use SQL Server, you would install the Microsoft.EntityFrameworkCore.SqlServer package.

You would then configure your database context to use the SQL Server provider:

using Microsoft.EntityFrameworkCore;

public class MyDbContext : DbContext
{
    protected override void OnConfiguring(DbContextOptionsBuilder options)
        => options.UseSqlServer(@"Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=MyDatabase");

    public DbSet<Customer> Customers { get; set; }
}

public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

Additional documentation

Feedback

If you have a specific question about using these projects, we encourage you to ask it on Stack Overflow. If you encounter a bug or would like to request a feature, submit an Github issue. For more details, see getting support.

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 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (8.5K)

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

Package Downloads
Microsoft.EntityFrameworkCore.Relational

Shared Entity Framework Core components for relational database providers.

Microsoft.EntityFrameworkCore.InMemory

In-memory database provider for Entity Framework Core (to be used for testing purposes).

Npgsql.EntityFrameworkCore.PostgreSQL

PostgreSQL/Npgsql provider for Entity Framework Core.

Microsoft.EntityFrameworkCore.Proxies

Lazy loading proxies for Entity Framework Core.

Microsoft.AspNetCore.App

Provides a default set of APIs for building an ASP.NET Core application. This package requires the ASP.NET Core runtime. This runtime is installed by the .NET Core SDK, or can be acquired separately using installers available at https://aka.ms/dotnet-download.

GitHub repositories (606)

Showing the top 5 popular GitHub repositories that depend on Microsoft.EntityFrameworkCore:

Repository Stars
jasontaylordev/CleanArchitecture
Clean Architecture Solution Template for ASP.NET Core
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
kgrzybek/modular-monolith-with-ddd
Full Modular Monolith application with Domain-Driven Design approach.
Version Downloads Last updated
9.0.2 69,705 2/11/2025
9.0.1 1,383,300 1/14/2025
9.0.0 5,680,663 11/12/2024
9.0.0-rc.2.24474.1 164,483 10/8/2024
9.0.0-rc.1.24451.1 111,037 9/10/2024
9.0.0-preview.7.24405.3 66,665 8/13/2024
9.0.0-preview.6.24327.4 80,602 7/9/2024
9.0.0-preview.5.24306.3 37,318 6/11/2024
9.0.0-preview.4.24267.1 53,291 5/21/2024
9.0.0-preview.3.24172.4 163,683 4/11/2024
9.0.0-preview.2.24128.4 60,304 3/12/2024
9.0.0-preview.1.24081.2 89,091 2/13/2024
8.0.13 35,982 2/11/2025
8.0.12 856,052 1/14/2025
8.0.11 6,095,524 11/12/2024
8.0.10 11,805,612 10/8/2024
8.0.8 17,244,086 8/13/2024
8.0.7 11,501,414 7/9/2024
8.0.6 13,732,664 5/28/2024
8.0.5 6,033,267 5/14/2024
8.0.4 21,601,106 4/9/2024
8.0.3 9,501,516 3/12/2024
8.0.2 17,726,413 2/13/2024
8.0.1 12,086,254 1/9/2024
8.0.0 32,970,452 11/14/2023
8.0.0-rc.2.23480.1 485,748 10/10/2023
8.0.0-rc.1.23419.6 139,226 9/12/2023
8.0.0-preview.7.23375.4 105,897 8/8/2023
8.0.0-preview.6.23329.4 177,146 7/11/2023
8.0.0-preview.5.23280.1 134,491 6/13/2023
8.0.0-preview.4.23259.3 128,508 5/16/2023
8.0.0-preview.3.23174.2 203,179 4/11/2023
8.0.0-preview.2.23128.3 191,660 3/14/2023
8.0.0-preview.1.23111.4 136,789 2/21/2023
7.0.20 2,355,048 5/28/2024
7.0.19 443,273 5/14/2024
7.0.18 1,870,476 4/9/2024
7.0.17 1,463,652 3/12/2024
7.0.16 1,876,857 2/13/2024
7.0.15 2,942,252 1/9/2024
7.0.14 5,596,999 11/14/2023
7.0.13 6,098,859 10/24/2023
7.0.12 4,156,197 10/10/2023
7.0.11 12,493,734 9/12/2023
7.0.10 9,150,630 8/8/2023
7.0.9 8,418,306 7/11/2023
7.0.8 5,214,507 6/22/2023
7.0.7 3,621,580 6/13/2023
7.0.5 24,326,070 4/11/2023
7.0.4 9,083,373 3/14/2023
7.0.3 13,168,506 2/14/2023
7.0.2 17,802,200 1/10/2023
7.0.1 9,594,509 12/13/2022
7.0.0 27,139,102 11/7/2022
7.0.0-rc.2.22472.11 214,154 10/11/2022
7.0.0-rc.1.22426.7 212,216 9/14/2022
7.0.0-preview.7.22376.2 94,870 8/9/2022
7.0.0-preview.6.22329.4 74,642 7/12/2022
7.0.0-preview.5.22302.2 63,776 6/14/2022
7.0.0-preview.4.22229.2 80,304 5/10/2022
7.0.0-preview.3.22175.1 77,601 4/13/2022
7.0.0-preview.2.22153.1 85,473 3/14/2022
7.0.0-preview.1.22076.6 57,195 2/17/2022
6.0.36 413,868 11/12/2024
6.0.35 436,611 10/8/2024
6.0.33 1,195,120 8/13/2024
6.0.32 621,888 7/9/2024
6.0.31 895,141 5/28/2024
6.0.30 449,438 5/14/2024
6.0.29 2,251,221 4/9/2024
6.0.28 1,331,243 3/12/2024
6.0.27 1,650,250 2/13/2024
6.0.26 2,407,289 1/9/2024
6.0.25 3,297,356 11/14/2023
6.0.24 1,708,881 10/24/2023
6.0.23 1,166,475 10/10/2023
6.0.22 3,153,099 9/12/2023
6.0.21 3,343,286 8/8/2023
6.0.20 2,692,995 7/11/2023
6.0.19 2,248,238 6/22/2023
6.0.18 1,212,117 6/13/2023
6.0.16 7,102,225 4/11/2023
6.0.15 3,974,414 3/14/2023
6.0.14 5,016,334 2/14/2023
6.0.13 6,642,494 1/10/2023
6.0.12 10,296,176 12/13/2022
6.0.11 9,503,810 11/7/2022
6.0.10 16,844,303 10/11/2022
6.0.9 14,764,207 9/13/2022
6.0.8 17,670,348 8/9/2022
6.0.7 47,661,642 7/12/2022
6.0.6 14,212,255 6/14/2022
6.0.5 21,699,790 5/10/2022
6.0.4 17,388,410 4/11/2022
6.0.3 23,533,848 3/8/2022
6.0.2 19,185,870 2/8/2022
6.0.1 31,588,635 12/14/2021
6.0.0 63,862,449 11/8/2021
6.0.0-rc.2.21480.5 319,724 10/12/2021
6.0.0-rc.1.21452.10 246,493 9/14/2021
6.0.0-preview.7.21378.4 95,385 8/10/2021
6.0.0-preview.6.21352.1 43,349 7/14/2021
6.0.0-preview.5.21301.9 184,604 6/15/2021
6.0.0-preview.4.21253.1 71,563 5/24/2021
6.0.0-preview.3.21201.2 94,686 4/8/2021
6.0.0-preview.2.21154.2 72,865 3/11/2021
6.0.0-preview.1.21102.2 94,623 2/12/2021
5.0.17 7,304,084 5/10/2022 5.0.17 is deprecated because it is no longer maintained.
5.0.16 1,464,163 4/11/2022 5.0.16 is deprecated because it is no longer maintained.
5.0.15 2,287,672 3/8/2022 5.0.15 is deprecated because it is no longer maintained.
5.0.14 2,321,171 2/8/2022 5.0.14 is deprecated because it is no longer maintained.
5.0.13 4,354,976 12/14/2021 5.0.13 is deprecated because it is no longer maintained.
5.0.12 4,751,877 11/7/2021 5.0.12 is deprecated because it is no longer maintained.
5.0.11 8,272,011 10/12/2021 5.0.11 is deprecated because it is no longer maintained.
5.0.10 13,141,893 9/14/2021 5.0.10 is deprecated because it is no longer maintained.
5.0.9 10,141,327 8/10/2021 5.0.9 is deprecated because it is no longer maintained.
5.0.8 9,414,340 7/13/2021 5.0.8 is deprecated because it is no longer maintained.
5.0.7 14,177,614 6/8/2021 5.0.7 is deprecated because it is no longer maintained.
5.0.6 8,087,714 5/11/2021 5.0.6 is deprecated because it is no longer maintained.
5.0.5 11,256,158 4/6/2021 5.0.5 is deprecated because it is no longer maintained.
5.0.4 8,190,397 3/9/2021 5.0.4 is deprecated because it is no longer maintained.
5.0.3 8,001,346 2/9/2021 5.0.3 is deprecated because it is no longer maintained.
5.0.2 10,431,417 1/12/2021 5.0.2 is deprecated because it is no longer maintained.
5.0.1 15,664,264 12/8/2020 5.0.1 is deprecated because it is no longer maintained.
5.0.0 26,042,811 11/9/2020 5.0.0 is deprecated because it is no longer maintained.
5.0.0-rc.2.20475.6 377,456 10/13/2020
5.0.0-rc.1.20451.13 318,007 9/14/2020
5.0.0-preview.8.20407.4 201,431 8/25/2020
5.0.0-preview.7.20365.15 113,761 7/21/2020
5.0.0-preview.6.20312.4 63,578 6/25/2020
5.0.0-preview.5.20278.2 48,472 6/10/2020
5.0.0-preview.4.20220.10 73,351 5/18/2020
5.0.0-preview.3.20181.2 93,974 4/23/2020
5.0.0-preview.2.20159.4 61,228 4/2/2020
5.0.0-preview.2.20120.8 45,869 3/16/2020
3.1.32 4,883,548 12/13/2022
3.1.31 989,239 11/8/2022
3.1.30 700,245 10/11/2022
3.1.29 1,182,857 9/13/2022
3.1.28 811,558 8/9/2022
3.1.27 720,532 7/12/2022
3.1.26 626,589 6/14/2022
3.1.25 1,062,435 5/10/2022
3.1.24 644,912 4/11/2022
3.1.23 1,043,408 3/8/2022
3.1.22 3,312,701 12/14/2021
3.1.21 2,573,794 11/7/2021
3.1.20 1,513,025 10/11/2021
3.1.19 2,438,538 9/14/2021
3.1.18 5,184,952 8/10/2021
3.1.17 1,857,504 7/13/2021
3.1.16 2,353,148 6/8/2021
3.1.15 2,782,224 5/11/2021
3.1.14 3,080,727 4/6/2021
3.1.13 4,534,401 3/9/2021
3.1.12 2,980,317 2/9/2021
3.1.11 5,391,798 1/12/2021
3.1.10 8,297,343 11/9/2020
3.1.9 11,928,631 10/13/2020
3.1.8 17,616,122 9/8/2020
3.1.7 9,941,304 8/11/2020
3.1.6 10,699,532 7/14/2020
3.1.5 12,715,952 6/9/2020
3.1.4 17,788,228 5/12/2020
3.1.3 27,671,674 3/24/2020
3.1.2 11,826,611 2/19/2020
3.1.1 19,821,262 1/14/2020
3.1.0 33,787,864 12/3/2019
3.1.0-preview3.19554.8 164,151 11/13/2019
3.1.0-preview2.19525.5 32,523 11/1/2019
3.1.0-preview1.19506.2 750,820 10/15/2019
3.0.3 186,159 2/19/2020
3.0.2 79,694 1/14/2020
3.0.1 1,393,848 11/18/2019
3.0.0 18,806,912 9/23/2019
3.0.0-rc1.19456.14 46,478 9/16/2019
3.0.0-preview9.19423.6 1,370,553 9/4/2019
3.0.0-preview8.19405.11 412,353 8/13/2019
3.0.0-preview7.19362.6 90,112 7/23/2019
3.0.0-preview6.19304.10 167,104 6/12/2019
3.0.0-preview5.19227.1 670,861 5/6/2019
3.0.0-preview4.19216.3 22,794 4/18/2019
3.0.0-preview3.19153.1 201,887 3/6/2019
3.0.0-preview.19074.3 31,068 1/29/2019
3.0.0-preview.18572.1 48,238 12/3/2018
2.3.0 2,452 1/14/2025
2.2.6 31,393,706 7/9/2019 2.2.6 is deprecated because it is no longer maintained.
2.2.4 19,403,935 4/9/2019 2.2.4 is deprecated because it is no longer maintained.
2.2.3 5,307,949 3/11/2019 2.2.3 is deprecated because it is no longer maintained.
2.2.2 6,391,503 2/12/2019 2.2.2 is deprecated because it is no longer maintained.
2.2.1 6,846,932 1/8/2019 2.2.1 is deprecated because it is no longer maintained.
2.2.0 21,311,666 12/3/2018 2.2.0 is deprecated because it is no longer maintained.
2.2.0-preview3-35497 184,413 10/17/2018
2.2.0-preview2-35157 146,853 9/12/2018
2.2.0-preview1-35029 81,108 8/22/2018
2.1.14 3,901,371 11/18/2019
2.1.11 3,683,240 5/14/2019
2.1.8 3,710,633 2/12/2019
2.1.4 15,445,290 10/1/2018
2.1.3 4,871,940 9/11/2018
2.1.2 8,068,105 8/21/2018
2.1.1 15,937,217 6/18/2018
2.1.0 13,139,768 5/29/2018
2.1.0-rc1-final 223,212 5/6/2018
2.1.0-preview2-final 204,249 4/10/2018
2.1.0-preview1-final 315,865 2/26/2018
2.0.3 5,283,169 5/7/2018 2.0.3 is deprecated because it is no longer maintained.
2.0.2 6,607,577 3/13/2018 2.0.2 is deprecated because it is no longer maintained.
2.0.1 12,384,890 11/14/2017 2.0.1 is deprecated because it is no longer maintained.
2.0.0 26,861,509 8/11/2017 2.0.0 is deprecated because it is no longer maintained.
2.0.0-preview2-final 95,610 6/28/2017 2.0.0-preview2-final is deprecated because it is no longer maintained.
2.0.0-preview1-final 1,105,656 5/10/2017 2.0.0-preview1-final is deprecated because it is no longer maintained.
1.1.6 5,697,143 7/10/2018 1.1.6 is deprecated because it is no longer maintained.
1.1.5 1,240,920 12/12/2017 1.1.5 is deprecated because it is no longer maintained.
1.1.4 220,669 11/14/2017 1.1.4 is deprecated because it is no longer maintained.
1.1.3 307,046 9/20/2017 1.1.3 is deprecated because it is no longer maintained.
1.1.2 4,920,509 5/9/2017 1.1.2 is deprecated because it is no longer maintained.
1.1.1 3,114,764 3/6/2017 1.1.1 is deprecated because it is no longer maintained.
1.1.0 6,927,293 11/16/2016 1.1.0 is deprecated because it is no longer maintained.
1.1.0-preview1-final 46,330 10/24/2016 1.1.0-preview1-final is deprecated because it is no longer maintained.
1.0.6 54,030 11/14/2017 1.0.6 is deprecated because it is no longer maintained.
1.0.5 42,534 9/20/2017 1.0.5 is deprecated because it is no longer maintained.
1.0.4 57,298 5/9/2017 1.0.4 is deprecated because it is no longer maintained.
1.0.3 630,752 3/6/2017 1.0.3 is deprecated because it is no longer maintained.
1.0.2 78,035 12/12/2016 1.0.2 is deprecated because it is no longer maintained.
1.0.1 759,514 9/13/2016 1.0.1 is deprecated because it is no longer maintained.
1.0.0 1,621,734 6/27/2016 1.0.0 is deprecated because it is no longer maintained.
1.0.0-rc2-final 137,653 5/16/2016 1.0.0-rc2-final is deprecated because it is no longer maintained.