JsonNode .NET 8 の API アップデート

.NET 8 の一環として、JsonNode と JsonArray の API にいくつかの追加が入っています。ディープコピーとディープイコールについては 以前の記事で取り上げました が、それ以外にもあります。

GetValueKind

public JsonValueKind GetValueKind(JsonSerializerOptions options = null);

現在のインスタンスの JsonValueKind を返します。

GetPropertyName

public string GetPropertyName();

親オブジェクトから見たときの、現在のノードのプロパティ名を返します。親が JsonObject でない場合は InvalidOperationException をスローします。

GetElementIndex

public int GetElementIndex();

親 JsonArray から見たときの、現在のノードのインデックスを返します。親が JsonArray でない場合は InvalidOperationException をスローします。

ReplaceWith<T>

public void ReplaceWith<T>(T value);

指定したノードを与えられた値で置き換えます。

ParseAsync

public static Task<JsonNode?> ParseAsync(
        Stream utf8Json,
        JsonNodeOptions? nodeOptions = null,
        JsonDocumentOptions documentOptions = default,
        CancellationToken cancellationToken = default);

単一の JSON 値を表す UTF-8 エンコードのデータストリームを、非同期に JsonNode にパースします。