Microsoft.EntityFrameworkCore 9.0.0

Prefix Reserved

Requires NuGet 3.6 or higher.

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

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

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

NuGet packages (8.2K)

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

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.0 892,099 11/12/2024
9.0.0-rc.2.24474.1 121,164 10/8/2024
9.0.0-rc.1.24451.1 88,323 9/10/2024
9.0.0-preview.7.24405.3 45,499 8/13/2024
9.0.0-preview.6.24327.4 67,842 7/9/2024
9.0.0-preview.5.24306.3 33,370 6/11/2024
9.0.0-preview.4.24267.1 47,369 5/21/2024
9.0.0-preview.3.24172.4 155,519 4/11/2024
9.0.0-preview.2.24128.4 54,138 3/12/2024
9.0.0-preview.1.24081.2 76,783 2/13/2024
8.0.11 1,049,541 11/12/2024
8.0.10 6,668,775 10/8/2024
8.0.8 12,700,162 8/13/2024
8.0.7 9,222,482 7/9/2024
8.0.6 11,474,212 5/28/2024
8.0.5 5,099,838 5/14/2024
8.0.4 17,911,424 4/9/2024
8.0.3 8,303,120 3/12/2024
8.0.2 14,734,548 2/13/2024
8.0.1 10,657,935 1/9/2024
8.0.0 27,039,770 11/14/2023
8.0.0-rc.2.23480.1 459,175 10/10/2023
8.0.0-rc.1.23419.6 134,469 9/12/2023
8.0.0-preview.7.23375.4 99,304 8/8/2023
8.0.0-preview.6.23329.4 161,417 7/11/2023
8.0.0-preview.5.23280.1 128,775 6/13/2023
8.0.0-preview.4.23259.3 123,383 5/16/2023
8.0.0-preview.3.23174.2 189,391 4/11/2023
8.0.0-preview.2.23128.3 188,982 3/14/2023
8.0.0-preview.1.23111.4 134,780 2/21/2023
7.0.20 1,778,486 5/28/2024
7.0.19 394,070 5/14/2024
7.0.18 1,606,969 4/9/2024
7.0.17 1,352,095 3/12/2024
7.0.16 1,752,965 2/13/2024
7.0.15 2,751,483 1/9/2024
7.0.14 5,281,128 11/14/2023
7.0.13 5,697,599 10/24/2023
7.0.12 3,980,718 10/10/2023
7.0.11 11,894,002 9/12/2023
7.0.10 8,797,892 8/8/2023
7.0.9 7,995,363 7/11/2023
7.0.8 5,049,210 6/22/2023
7.0.7 3,509,435 6/13/2023
7.0.5 23,471,861 4/11/2023
7.0.4 8,859,402 3/14/2023
7.0.3 12,758,091 2/14/2023
7.0.2 17,084,886 1/10/2023
7.0.1 9,316,545 12/13/2022
7.0.0 25,374,724 11/7/2022
7.0.0-rc.2.22472.11 210,785 10/11/2022
7.0.0-rc.1.22426.7 210,355 9/14/2022
7.0.0-preview.7.22376.2 92,888 8/9/2022
7.0.0-preview.6.22329.4 72,407 7/12/2022
7.0.0-preview.5.22302.2 62,401 6/14/2022
7.0.0-preview.4.22229.2 76,899 5/10/2022
7.0.0-preview.3.22175.1 76,778 4/13/2022
7.0.0-preview.2.22153.1 84,527 3/14/2022
7.0.0-preview.1.22076.6 56,035 2/17/2022
6.0.36 71,949 11/12/2024
6.0.35 263,473 10/8/2024
6.0.33 806,800 8/13/2024
6.0.32 515,850 7/9/2024
6.0.31 776,510 5/28/2024
6.0.30 390,277 5/14/2024
6.0.29 1,943,221 4/9/2024
6.0.28 1,176,404 3/12/2024
6.0.27 1,502,374 2/13/2024
6.0.26 2,243,538 1/9/2024
6.0.25 3,070,300 11/14/2023
6.0.24 1,600,580 10/24/2023
6.0.23 1,113,994 10/10/2023
6.0.22 2,983,805 9/12/2023
6.0.21 3,180,236 8/8/2023
6.0.20 2,574,705 7/11/2023
6.0.19 2,119,335 6/22/2023
6.0.18 1,162,936 6/13/2023
6.0.16 6,828,530 4/11/2023
6.0.15 3,835,618 3/14/2023
6.0.14 4,819,991 2/14/2023
6.0.13 6,458,887 1/10/2023
6.0.12 9,886,535 12/13/2022
6.0.11 9,230,962 11/7/2022
6.0.10 16,385,736 10/11/2022
6.0.9 14,409,120 9/13/2022
6.0.8 17,167,451 8/9/2022
6.0.7 46,249,596 7/12/2022
6.0.6 13,851,181 6/14/2022
6.0.5 21,141,005 5/10/2022
6.0.4 17,021,760 4/11/2022
6.0.3 22,623,253 3/8/2022
6.0.2 18,812,922 2/8/2022
6.0.1 30,826,740 12/14/2021
6.0.0 60,683,146 11/8/2021
6.0.0-rc.2.21480.5 315,014 10/12/2021
6.0.0-rc.1.21452.10 236,538 9/14/2021
6.0.0-preview.7.21378.4 94,116 8/10/2021
6.0.0-preview.6.21352.1 43,078 7/14/2021
6.0.0-preview.5.21301.9 182,754 6/15/2021
6.0.0-preview.4.21253.1 71,362 5/24/2021
6.0.0-preview.3.21201.2 93,817 4/8/2021
6.0.0-preview.2.21154.2 72,807 3/11/2021
6.0.0-preview.1.21102.2 93,486 2/12/2021
5.0.17 7,020,696 5/10/2022 5.0.17 is deprecated because it is no longer maintained.
5.0.16 1,439,684 4/11/2022 5.0.16 is deprecated because it is no longer maintained.
5.0.15 2,214,237 3/8/2022 5.0.15 is deprecated because it is no longer maintained.
5.0.14 2,298,233 2/8/2022 5.0.14 is deprecated because it is no longer maintained.
5.0.13 4,281,423 12/14/2021 5.0.13 is deprecated because it is no longer maintained.
5.0.12 4,687,753 11/7/2021 5.0.12 is deprecated because it is no longer maintained.
5.0.11 8,169,036 10/12/2021 5.0.11 is deprecated because it is no longer maintained.
5.0.10 12,948,081 9/14/2021 5.0.10 is deprecated because it is no longer maintained.
5.0.9 10,015,479 8/10/2021 5.0.9 is deprecated because it is no longer maintained.
5.0.8 9,244,887 7/13/2021 5.0.8 is deprecated because it is no longer maintained.
5.0.7 14,016,902 6/8/2021 5.0.7 is deprecated because it is no longer maintained.
5.0.6 8,002,812 5/11/2021 5.0.6 is deprecated because it is no longer maintained.
5.0.5 11,103,360 4/6/2021 5.0.5 is deprecated because it is no longer maintained.
5.0.4 8,104,920 3/9/2021 5.0.4 is deprecated because it is no longer maintained.
5.0.3 7,941,484 2/9/2021 5.0.3 is deprecated because it is no longer maintained.
5.0.2 10,309,142 1/12/2021 5.0.2 is deprecated because it is no longer maintained.
5.0.1 15,466,873 12/8/2020 5.0.1 is deprecated because it is no longer maintained.
5.0.0 25,505,243 11/9/2020 5.0.0 is deprecated because it is no longer maintained.
5.0.0-rc.2.20475.6 374,931 10/13/2020
5.0.0-rc.1.20451.13 317,102 9/14/2020
5.0.0-preview.8.20407.4 200,055 8/25/2020
5.0.0-preview.7.20365.15 113,120 7/21/2020
5.0.0-preview.6.20312.4 63,200 6/25/2020
5.0.0-preview.5.20278.2 48,088 6/10/2020
5.0.0-preview.4.20220.10 73,078 5/18/2020
5.0.0-preview.3.20181.2 93,471 4/23/2020
5.0.0-preview.2.20159.4 60,899 4/2/2020
5.0.0-preview.2.20120.8 45,710 3/16/2020
3.1.32 4,321,483 12/13/2022
3.1.31 885,253 11/8/2022
3.1.30 667,496 10/11/2022
3.1.29 1,090,938 9/13/2022
3.1.28 783,828 8/9/2022
3.1.27 704,248 7/12/2022
3.1.26 601,996 6/14/2022
3.1.25 1,034,970 5/10/2022
3.1.24 632,953 4/11/2022
3.1.23 1,021,521 3/8/2022
3.1.22 3,186,517 12/14/2021
3.1.21 2,518,841 11/7/2021
3.1.20 1,460,781 10/11/2021
3.1.19 2,401,491 9/14/2021
3.1.18 5,089,334 8/10/2021
3.1.17 1,830,541 7/13/2021
3.1.16 2,323,999 6/8/2021
3.1.15 2,711,103 5/11/2021
3.1.14 3,047,371 4/6/2021
3.1.13 4,467,224 3/9/2021
3.1.12 2,943,263 2/9/2021
3.1.11 5,325,692 1/12/2021
3.1.10 8,236,538 11/9/2020
3.1.9 11,825,149 10/13/2020
3.1.8 17,500,953 9/8/2020
3.1.7 9,825,596 8/11/2020
3.1.6 10,609,924 7/14/2020
3.1.5 12,559,015 6/9/2020
3.1.4 17,607,218 5/12/2020
3.1.3 27,363,252 3/24/2020
3.1.2 11,727,720 2/19/2020
3.1.1 19,628,792 1/14/2020
3.1.0 33,286,551 12/3/2019
3.1.0-preview3.19554.8 163,882 11/13/2019
3.1.0-preview2.19525.5 32,316 11/1/2019
3.1.0-preview1.19506.2 741,570 10/15/2019
3.0.3 183,208 2/19/2020
3.0.2 79,262 1/14/2020
3.0.1 1,383,409 11/18/2019
3.0.0 18,595,068 9/23/2019
3.0.0-rc1.19456.14 46,331 9/16/2019
3.0.0-preview9.19423.6 1,360,066 9/4/2019
3.0.0-preview8.19405.11 411,953 8/13/2019
3.0.0-preview7.19362.6 89,881 7/23/2019
3.0.0-preview6.19304.10 166,368 6/12/2019
3.0.0-preview5.19227.1 670,312 5/6/2019
3.0.0-preview4.19216.3 22,721 4/18/2019
3.0.0-preview3.19153.1 201,317 3/6/2019
3.0.0-preview.19074.3 30,813 1/29/2019
3.0.0-preview.18572.1 47,924 12/3/2018
2.2.6 31,079,096 7/9/2019 2.2.6 is deprecated because it is no longer maintained.
2.2.4 19,279,275 4/9/2019 2.2.4 is deprecated because it is no longer maintained.
2.2.3 5,284,228 3/11/2019 2.2.3 is deprecated because it is no longer maintained.
2.2.2 6,354,032 2/12/2019 2.2.2 is deprecated because it is no longer maintained.
2.2.1 6,810,243 1/8/2019 2.2.1 is deprecated because it is no longer maintained.
2.2.0 20,986,662 12/3/2018 2.2.0 is deprecated because it is no longer maintained.
2.2.0-preview3-35497 184,087 10/17/2018
2.2.0-preview2-35157 145,260 9/12/2018
2.2.0-preview1-35029 80,947 8/22/2018
2.1.14 3,837,142 11/18/2019
2.1.11 3,669,706 5/14/2019
2.1.8 3,651,957 2/12/2019
2.1.4 15,362,214 10/1/2018
2.1.3 4,856,120 9/11/2018
2.1.2 8,033,276 8/21/2018
2.1.1 15,488,707 6/18/2018
2.1.0 13,030,548 5/29/2018
2.1.0-rc1-final 222,230 5/6/2018
2.1.0-preview2-final 203,375 4/10/2018
2.1.0-preview1-final 315,126 2/26/2018
2.0.3 5,238,629 5/7/2018 2.0.3 is deprecated because it is no longer maintained.
2.0.2 6,548,659 3/13/2018 2.0.2 is deprecated because it is no longer maintained.
2.0.1 12,277,496 11/14/2017 2.0.1 is deprecated because it is no longer maintained.
2.0.0 26,484,745 8/11/2017 2.0.0 is deprecated because it is no longer maintained.
2.0.0-preview2-final 95,269 6/28/2017 2.0.0-preview2-final is deprecated because it is no longer maintained.
2.0.0-preview1-final 1,094,437 5/10/2017 2.0.0-preview1-final is deprecated because it is no longer maintained.
1.1.6 5,577,847 7/10/2018 1.1.6 is deprecated because it is no longer maintained.
1.1.5 1,233,871 12/12/2017 1.1.5 is deprecated because it is no longer maintained.
1.1.4 218,508 11/14/2017 1.1.4 is deprecated because it is no longer maintained.
1.1.3 305,910 9/20/2017 1.1.3 is deprecated because it is no longer maintained.
1.1.2 4,855,654 5/9/2017 1.1.2 is deprecated because it is no longer maintained.
1.1.1 3,066,123 3/6/2017 1.1.1 is deprecated because it is no longer maintained.
1.1.0 6,642,342 11/16/2016 1.1.0 is deprecated because it is no longer maintained.
1.1.0-preview1-final 46,195 10/24/2016 1.1.0-preview1-final is deprecated because it is no longer maintained.
1.0.6 53,217 11/14/2017 1.0.6 is deprecated because it is no longer maintained.
1.0.5 42,167 9/20/2017 1.0.5 is deprecated because it is no longer maintained.
1.0.4 56,841 5/9/2017 1.0.4 is deprecated because it is no longer maintained.
1.0.3 612,037 3/6/2017 1.0.3 is deprecated because it is no longer maintained.
1.0.2 77,842 12/12/2016 1.0.2 is deprecated because it is no longer maintained.
1.0.1 717,333 9/13/2016 1.0.1 is deprecated because it is no longer maintained.
1.0.0 1,526,411 6/27/2016 1.0.0 is deprecated because it is no longer maintained.
1.0.0-rc2-final 135,123 5/16/2016 1.0.0-rc2-final is deprecated because it is no longer maintained.