KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

EfCoreJsonValueConverter

★ 98 Open GitHub ↗

JSON ValueConverter for EF Core 3.0+

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# JSON value converter for Entity Framework Core 3.0+

![Publish NuGet](https://github.com/Innofactor/EfCoreJsonValueConverter/workflows/Publish%20NuGet/badge.svg)

Serializes object properties in database as JSON blobs using [Entity Framework Core value converters](https://docs.microsoft.com/en-us/ef/core/modeling/value-conversions).

## Usage example

Installing:
```
PM> Install-Package Innofactor.EfCoreJsonValueConverter
```

Annotate model properties with the ```JsonField``` attribute:
```csharp
public class Customer {
  [JsonField]
  public Address Address { get; set; }
}

public class Address {
  // ...
}
```

This will persist Address property in database as JSON.

For DbContext:

```csharp
  protected override void OnModelCreating(ModelBuilder builder) {

builder.Entity<Customer>();
    builder.AddJsonFields();        
    
  }
```

Alternatively, individual fields can be mapped with the HasJsonValueConversion method:
```csharp
  protected override void OnModelCreating(ModelBuilder builder) {

builder.Entity<Customer>()
      .Property(m => m.Address)
      .HasJsonValueConversion();
    
  }
```

## Note on performance

EF Core requires that tracked objects implement deep cloning and comparison.
This library includes default fallback implementations for cloning and comparing, 
but for large objects that default implementation may be inefficient. 
To improve performance, it is recommended to manually implement ICloneable and IEquatable<T> interfaces for complex
JSON serialized objects. This library will then make use of those interfaces.

```csharp
public class Address : ICloneable, IEquatable<Address> {
  // ...
}
```

EfCoreJsonValueConverter

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README