DeepDiff 1.6.4

There is a newer version of this package available.
See the version list below for details.
dotnet add package DeepDiff --version 1.6.4
                    
NuGet\Install-Package DeepDiff -Version 1.6.4
                    
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.6.4" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DeepDiff" Version="1.6.4" />
                    
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.6.4
                    
#r "nuget: DeepDiff, 1.6.4"
                    
#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.6.4
                    
#: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.6.4
                    
Install as a Cake Addin
#tool nuget:?package=DeepDiff&version=1.6.4
                    
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 result = deepDiff.DiffMany(existingEntities, newEntities); // result.Entities will contain 'diff' entities

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 decimal 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 Guid EntityId { get; set; } // Foreign Key
}

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.11.0 173 9/24/2025
1.10.1 263 5/7/2025
1.10.0 183 4/11/2025
1.9.5 217 4/7/2025
1.9.4 218 4/7/2025
1.9.3 148 4/5/2025
1.9.2 167 4/4/2025
1.9.1 204 3/13/2025
1.9.0 279 3/4/2025
1.8.9 155 2/26/2025
1.8.8 148 2/26/2025
1.8.7 154 2/25/2025
1.8.6 154 2/25/2025
1.8.5 150 1/22/2025
1.8.4 158 1/21/2025
1.8.3 150 1/8/2025
1.8.2 198 7/2/2024
1.8.1 178 6/27/2024
1.8.0 169 6/21/2024
1.7.0 198 4/30/2024
1.6.4 183 4/26/2024
1.6.3 192 3/15/2024
1.6.2 172 2/27/2024
1.6.1 182 2/26/2024
1.6.0 169 2/22/2024
1.5.1 206 2/14/2024
1.5.0 546 1/31/2024
1.4.2 152 1/30/2024
1.4.1 165 1/30/2024
1.4.0 173 1/29/2024
1.3.6 175 1/27/2024
1.3.5 167 1/26/2024
1.3.4 162 1/26/2024
1.3.3 212 1/26/2024
1.3.2 159 1/25/2024
1.3.1 173 1/24/2024
1.3.0 165 1/24/2024
1.2.3 172 1/18/2024
1.2.2 185 1/9/2024
1.2.1 218 12/15/2023
1.1.1 182 12/7/2023
1.1.0 254 12/4/2023
1.0.2 241 12/2/2023
1.0.1 238 12/1/2023
1.0.0 181 12/1/2023