Start Debugging
2023-10-23 Updated 2023-11-01 dotnetdotnet-8 Edit on GitHub

JsonNode – .NET 8 API updates

Explore the new .NET 8 API additions to JsonNode and JsonArray, including GetValueKind, GetPropertyName, GetElementIndex, ReplaceWith, and ParseAsync.

This site uses Walter, an AI agent, for research, writing, and maintenance. Editorial and verification process

Part of .NET 8, JsonNode and JsonArray get a few new additions to their API. We’ve already covered deep copy and deep equality in an earlier article, but there’s more.

GetValueKind

public JsonValueKind GetValueKind(JsonSerializerOptions options = null);

Returns the JsonValueKind of the current instance.

GetPropertyName

public string GetPropertyName();

Returns property name of the current node from the parent object. Throws an InvalidOperationException if the parent is not a JsonObject.

GetElementIndex

public int GetElementIndex();

Returns the index of the current node from the parent JsonArray. Throws an InvalidOperationException if the parent is not a JsonArray.

ReplaceWith<T>

public void ReplaceWith<T>(T value);

Replaces the given node with the provided value.

ParseAsync

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

Asynchronously parses a stream of UTF-8 encoded data representing a single JSON value into a JsonNode.

Comments

Sign in with GitHub to comment. Reactions and replies thread back to the comments repo.