JsonNode API-Neuerungen in .NET 8

Mit .NET 8 erhalten JsonNode und JsonArray einige neue API-Erweiterungen. Über Deep Copy und Deep Equality haben wir bereits in einem früheren Artikel berichtet, aber es gibt noch mehr.

GetValueKind

public JsonValueKind GetValueKind(JsonSerializerOptions options = null);

Gibt den JsonValueKind der aktuellen Instanz zurück.

GetPropertyName

public string GetPropertyName();

Gibt den Property-Namen des aktuellen Knotens im übergeordneten Objekt zurück. Wirft eine InvalidOperationException, wenn das übergeordnete Element kein JsonObject ist.

GetElementIndex

public int GetElementIndex();

Gibt den Index des aktuellen Knotens im übergeordneten JsonArray zurück. Wirft eine InvalidOperationException, wenn das übergeordnete Element kein JsonArray ist.

ReplaceWith<T>

public void ReplaceWith<T>(T value);

Ersetzt den angegebenen Knoten durch den übergebenen Wert.

ParseAsync

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

Parst asynchron einen Stream UTF-8-kodierter Daten, der einen einzelnen JSON-Wert darstellt, in einen JsonNode.