Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / C#

System.Text.Json.JsonDocument: practical reference

System.Text.Json.JsonDocument: practical reference: JsonDocument parses UTF-8 JSON into an immutable tree backed by a shared buffer.

Version: .NET API; verified against .NET 10 reference surface

Syntax

System.Text.Json.JsonDocument /* select a documented member or constructor */

JsonDocument parses UTF-8 JSON into an immutable tree backed by a shared buffer.

Use it for efficient document reading without creating an object model.

It must be disposed; JsonElement depends on its lifetime unless Clone is used.

Invalid JSON throws JsonException, and a missing property can throw KeyNotFoundException.

The complete program actually uses System.Text.Json.JsonDocument; its exact expected stdout is 7.

Examples

using System;
using System.Buffers;
using System.Collections.Concurrent;
using System.Collections.Frozen;
using System.Collections.Generic;
using System.Collections.Immutable;
using System.Diagnostics;
using System.Globalization;
using System.IO;
using System.Linq;
using System.Linq.Expressions;
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
using System.Text;
using System.Text.Json;
using System.Text.Json.Nodes;
using System.Text.Json.Serialization;
using System.Text.RegularExpressions;
using System.Threading;
using System.Threading.Channels;
using System.Threading.Tasks;
using Number = System.Int32;

using var document = JsonDocument.Parse("{\"value\":7}");
Console.WriteLine(document.RootElement.GetProperty("value").GetInt32());

Result

7

The complete program actually uses `System.Text.Json.JsonDocument`; its exact expected stdout is `7`.

Sources