Nullable JsonDocument 속성이 JsonValueKind.Null로 역직렬화됩니다.

.NET 9부터 null JSON 값을 JsonDocument로 역직렬화하면, JsonValueKind.Null형식의 문서가 null이 아닌 상태로 생성됩니다.

using System.Text.Json;

var doc = JsonSerializer.Deserialize<JsonDocument>("null");

// Returns true in .NET 8 and false in .NET 9.
Console.WriteLine(doc is null);

// Returns false in .NET 8 and true in .NET 9.
Console.WriteLine(doc is { RootElement.ValueKind: JsonValueKind.Null });

도입된 버전

.NET 9

이전 동작

.NET 8 및 이전 버전에서는 JSON 값 null을 JsonDocument으로 역직렬화하면 null 결과가 반환됩니다.

var doc = JsonSerializer.Deserialize<JsonDocument>("null");
Console.WriteLine(doc is null); // True.

새 동작

.NET 9부터 null JSON 값을 JsonDocument 역직렬화하면 null이 아닌 JsonValueKind.Null인스턴스가 반환됩니다.

var doc = JsonSerializer.Deserialize<JsonDocument>("null");
Console.WriteLine(doc is null); // False.
Console.WriteLine(doc is { RootElement.ValueKind: JsonValueKind.Null }); // True.

호환성이 손상되는 변경 유형

이 변경은 동작 변경.

변경 이유

이 변경은 문서의 루트 수준 JSON null과 중첩된 null 간의 불일치를 해결합니다. 또한 JsonDocument.Parse 메서드의 동작과 일치합니다. 반환 null 동작은 버그로 간주되어 예상된 결과와 일치하기 위해 업데이트되었습니다.

권장 작업

역직렬화된 개체가 JsonDocument 형식을 포함할 경우, JsonValueKind.Null대신 null을 예상하도록 코드를 업데이트합니다.

영향을 받는 API

• System.Text.Json.JsonSerializer.Deserialize
• System.Text.Json.JsonDocument