Ecng system framework
Get Started
$ dotnet add package Ecng.SerializationReadme
Ecng.Serialization
Helpers for JSON and high-performance binary serialization.
Purpose
Provide easy to use serializers with built in SettingsStorage support so objects can be persisted or transmitted with minimal code.
Key Features
- JSON serializer with indentation and enum string options
- Streaming API and asynchronous methods
- Custom converters and
IPersistablehelpers SpanWriter/SpanReaderfor compact binary format
JSON Example
var serializer = JsonSerializer<MyData>.CreateDefault();
await using var stream = File.OpenWrite("data.json");
await serializer.SerializeAsync(data, stream, CancellationToken.None);
await using var read = File.OpenRead("data.json");
var loaded = await serializer.DeserializeAsync(read, CancellationToken.None);
Same using standard .NET:
await System.Text.Json.JsonSerializer.SerializeAsync(stream, data);
Binary primitives
SpanWriter writer = stackalloc byte[256];
writer.WriteInt32(42);
writer.WriteString("hello");
var reader = new SpanReader(writer.Buffer);
int num = reader.ReadInt32();
string text = reader.ReadString();
SettingsStorage
var storage = new SettingsStorage();
myObj.Save(storage);
string raw = storage.SaveToString<JsonSerializer<SettingsStorage>>();
var restored = raw.LoadFromString<JsonSerializer<SettingsStorage>>();