FlexLabs.EntityFrameworkCore.Upsert 9.0.0

Prefix Reserved
.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher. 
dotnet add package FlexLabs.EntityFrameworkCore.Upsert --version 9.0.0
                    


                    

                
NuGet\Install-Package FlexLabs.EntityFrameworkCore.Upsert -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="FlexLabs.EntityFrameworkCore.Upsert" Version="9.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FlexLabs.EntityFrameworkCore.Upsert" Version="9.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FlexLabs.EntityFrameworkCore.Upsert" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add FlexLabs.EntityFrameworkCore.Upsert --version 9.0.0
                    


                    

                
#r "nuget: FlexLabs.EntityFrameworkCore.Upsert, 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. 
#addin nuget:?package=FlexLabs.EntityFrameworkCore.Upsert&version=9.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FlexLabs.EntityFrameworkCore.Upsert&version=9.0.0
                    


                            Install as a Cake Tool

FlexLabs.Upsert

Build status FlexLabs.EntityFrameworkCore.Upsert on NuGet
CI build: FlexLabs.EntityFrameworkCore.Upsert on MyGet

This library adds basic support for "Upsert" operations to EF Core.

Uses INSERT … ON CONFLICT DO UPDATE in PostgreSQL/Sqlite, MERGE in SqlServer & Oracle and INSERT INTO … ON DUPLICATE KEY UPDATE in MySQL.

Also supports injecting sql command runners to add support for other providers

A typical upsert command could look something like this:

DataContext.DailyVisits
    .Upsert(new DailyVisit
    {
        UserID = userID,
        Date = DateTime.UtcNow.Date,
        Visits = 1,
    })
    .On(v => new { v.UserID, v.Date })
    .WhenMatched(v => new DailyVisit
    {
        Visits = v.Visits + 1,
    })
    .RunAsync();

In this case, the upsert command will ensure that a new DailyVisit will be added to the database. If a visit with the same UserID and Date already exists, it will be updated by incrementing it's Visits value by 1.

Please read our Usage page for more examples

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

NuGet packages (14)

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

Package Downloads
FenixAlliance.ACL.Dependencies

Application Component for the Alliance Business Suite.
HwApp.Core

HwApp Core
Elsa.Persistence.EntityFrameworkCore

Elsa is a set of workflow libraries and tools that enable super-fast workflowing capabilities in any .NET Core application. This package provides an Entity Framework Core persistence provider.
QuantFi.Services

Package Description
YYApp

YYApp Core

GitHub repositories (3)

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

Repository Stars
PlexRipper/PlexRipper
A cross-platform Plex media downloader that seamlessly adds media from other Plex servers to your own!
Texnomic/SecureDNS
Secure, Modern, Fully-Featured, All-In-One Cross-Architecture & Cross-Platform DNS Server Using .NET 8.0
Kukks/NNostr
A Nostr Relay and Client written in C#
Version Downloads Last Updated
9.0.0 130,446 3/3/2025
8.1.2 358,518 11/28/2024
8.1.0 16,081 11/24/2024 8.1.0 is deprecated because it has critical bugs.
8.0.0 1,666,435 12/3/2023
7.0.0 1,052,519 12/18/2022
7.0.0-beta.2 6,335 11/22/2022
7.0.0-beta.1 479 11/16/2022
6.0.2 549,793 11/16/2022
6.0.1 4,456,092 1/2/2022
6.0.0-preview5 58,334 7/11/2021
5.1.0 68,899 1/2/2022
5.0.0 375,256 7/11/2021
4.0.1 39,222 7/11/2021
4.0.0 384,099 3/2/2021
3.1.0 2,382,289 1/26/2020
3.0.0 108,627 9/29/2019
3.0.0-netcore3-00140 3,732 8/11/2019
2.2.1 111,132 9/17/2019
2.2.0 44,489 8/11/2019
2.1.2 91,661 5/22/2019
2.1.1 2,452 5/21/2019
2.1.0 3,007 5/19/2019
2.0.7 54,317 3/18/2019
2.0.6 11,442 2/6/2019
2.0.5 17,759 1/25/2019
2.0.4 8,832 1/3/2019
2.0.3 7,295 12/18/2018
2.0.2 12,393 11/3/2018
2.0.1 2,812 10/24/2018
2.0.0 11,406 9/19/2018
1.1.0 2,414 9/19/2018
1.0.4 14,434 3/10/2018
1.0.3 2,752 2/23/2018
1.0.2 2,505 2/20/2018
1.0.1 2,626 2/19/2018
1.0.0 7,169 2/18/2018

v9.0.0
+ Adding support for EF Core 9

v8.1.0
+ Adding initial support for Oracle DB! (Thanks to @dadyarri)
+ Adding test support for returning inserted objects (Thanks to @PhenX)
+ Adding support for upserting into views (ymmv)
! Patching argument count calculation (for max argument count handling)
! Patching null constant handling in the update condition

v8.0.0
+ Adding support for EF Core 8

v7.0.0
+ Adding support for EF Core 7

v6.0.2
* Improving entity type detection when using DbSet<>
! Patching MySQL handling of null columns

v6.0.0
+ Adding support for EF Core 6
+ Handling UseIdentityAlwaysColumn columns

v5.0.0
! Fixing the library versioning. From now one, one version of the library depends on one version of EF Core, for all supported target frameworks

v4.0.1
! Patching some MySql conditional update queries

v4.0.0
+ Adding support for .NET 5 and EF Core 5
! Patched support for constants in the update condition
! Run and RunAsync will not return all rows affected when command was split into multiple batches, not just the last batch's row count
! Patching the extension method to replace/inject custom command runner
! Removed old extension method on IServiceCollection, since it wasn't working anyway