DeepDiff 1.1.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package DeepDiff --version 1.1.0
                    
NuGet\Install-Package DeepDiff -Version 1.1.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="DeepDiff" Version="1.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DeepDiff" Version="1.1.0" />
                    
Directory.Packages.props
<PackageReference Include="DeepDiff" />
                    
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 DeepDiff --version 1.1.0
                    
#r "nuget: DeepDiff, 1.1.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.
#:package DeepDiff@1.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DeepDiff&version=1.1.0
                    
Install as a Cake Addin
#tool nuget:?package=DeepDiff&version=1.1.0
                    
Install as a Cake Tool

Sample

How do I get started

First configure DeepDiff to know what types you want to compare, in the startup of your application

var diffConfiguration = new DiffConfiguration();
diffConfiguration.Entity<Entity>()
   .HasKey(x => new { x.StartsOn, x.Name })
   .HasValues(x => new { x.Price, x.Volume })
   .HasMany(x => x.SubEntities)
   .OnInsert(cfg => cfg.SetValue(x => x.PersistChange, PersistChange.Insert))
   .OnUpdate(cfg => cfg.SetValue(x => x.PersistChange, PersistChange.Update))
   .OnDelete(cfg => cfg.SetValue(x => x.PersistChange, PersistChange.Delete));
diffConfiguration.Entity<SubEntity>()
   .HasKey(x => x.SubName)
   .HasValues(x => x.Energy)
   .OnInsert(cfg => cfg.SetValue(x => x.PersistChange, PersistChange.Insert))
   .OnUpdate(cfg => cfg.SetValue(x => x.PersistChange, PersistChange.Update))
   .OnDelete(cfg => cfg.SetValue(x => x.PersistChange, PersistChange.Delete))
var deepDiff = diffConfiguration.CreateDeepDiff();

Then in your application code

var results = deepDiff.DiffMany(existingEntities, newEntities).ToArray();

Sample entities definition

public class Entity
{
  public Guid Id { get; set; } // DB Key
  public DateTime StartsOn { get; set; } // Business Key
  public string Name { get; set; } // Business Key
  public int Price { get; set; }
  public int Volume { get; set; }
  public PersistChange PersistChange { get; set; }
  public List<SubEntity> SubEntities { get; set; }
}

public class SubEntity
{
  public Guid Id { get; set; } // DB Key
  public string SubName { get; set; } // Business Key
  public int Energy { get; set; }
  public PersistChange PersistChange { get; set; }
}

public enum PersistChange
{
  None,
  Inserted,
  Updated,
  Deleted
}
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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.  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.
  • net5.0

    • No dependencies.
  • net6.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on DeepDiff:

Package Downloads
DeepDiff.Extensions.Microsoft.DependencyInjection

DeepDeef extensions for Microsft Dependendy Injection

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.10.1 176 5/7/2025
1.10.0 143 4/11/2025
1.9.5 180 4/7/2025
1.9.4 179 4/7/2025
1.9.3 112 4/5/2025
1.9.2 130 4/4/2025
1.9.1 166 3/13/2025
1.9.0 240 3/4/2025
1.8.9 118 2/26/2025
1.8.8 109 2/26/2025
1.8.7 115 2/25/2025
1.8.6 116 2/25/2025
1.8.5 113 1/22/2025
1.8.4 122 1/21/2025
1.8.3 110 1/8/2025
1.8.2 159 7/2/2024
1.8.1 140 6/27/2024
1.8.0 133 6/21/2024
1.7.0 157 4/30/2024
1.6.4 144 4/26/2024
1.6.3 152 3/15/2024
1.6.2 148 2/27/2024
1.6.1 146 2/26/2024
1.6.0 142 2/22/2024
1.5.1 171 2/14/2024
1.5.0 462 1/31/2024
1.4.2 127 1/30/2024
1.4.1 130 1/30/2024
1.4.0 137 1/29/2024
1.3.6 139 1/27/2024
1.3.5 133 1/26/2024
1.3.4 127 1/26/2024
1.3.3 160 1/26/2024
1.3.2 134 1/25/2024
1.3.1 137 1/24/2024
1.3.0 140 1/24/2024
1.2.3 143 1/18/2024
1.2.2 151 1/9/2024
1.2.1 182 12/15/2023
1.1.1 158 12/7/2023
1.1.0 198 12/4/2023
1.0.2 190 12/2/2023
1.0.1 188 12/1/2023
1.0.0 146 12/1/2023