
System.Text.Json is currently the most modern way to handle Json files efficiently. Efficiency here also means that memory sparing files are read in.
A very efficient way to handle Json files is not to load them into a string first, but to implement the deserialization via streams. This keeps the application more scalable and performant.
System.Text.Json has this built in, so such an implementation can be done within a few lines.
1// Create Client
2BlobContainerClient container = new(_options.ConnectionString, _options.ContainerName);
3BlobClient blobClient = container.GetBlobClient(_options.BlobPath);
4
5// check if blob exists
6Azure.Response<bool> exists = await blobClient.ExistsAsync(ct).ConfigureAwait(false);
7if (exists.Value is false)
8{
9 return null;
10}
11
12// Get Blob Stream
13BlobOpenReadOptions readOptions = new(allowModifications: false);
14using Stream stream = await blobClient.OpenReadAsync(readOptions, ct).ConfigureAwait(false);
15
16// read json
17JsonSerializerOptions jsonOpions = new();
18
19MyDeserializationTargetClass? myDeserializedObject = await JsonSerializer
20 .DeserializeAsync<MyDeserializationTargetClass>(stream, jsonOpions, ct)
21 .ConfigureAwait(false);
Related articles

Mar 10, 2026 · 15 min read
.NET NuGet Trusted Publishing with GitHub Actions
Publishing NuGet packages has traditionally required one uncomfortable compromise: a long-lived API key had to exist somewhere in the …

Mar 09, 2026 · 7 min read
C# 15 Unions: Unions are finally in .NET
After many years of workarounds, design discussions and library-level substitutes, unions are finally becoming a first-class part of C#. The …

Mar 02, 2026 · 19 min read
Unio: High-Performance Discriminated Unions for C#
C# is a powerful language, but there is one road it has not yet fully paved: native discriminated union types. Developers have been working …
Let's Work Together
Looking for an experienced Platform Architect or Engineer for your next project? Whether it's cloud migration, platform modernization or building new solutions from scratch - I'm here to help you succeed.

Comments