JsonElement Struct

Definition

Represents a specific JSON value within a JsonDocument.

public value class JsonElement
public readonly struct JsonElement
type JsonElement = struct
Public Structure JsonElement
Inheritance
JsonElement

Remarks

For more information, see Use JsonDocument for access to data.

Properties

Item[Int32]

Gets the value at the specified index if the current value is an Array.

ValueKind

Gets the type of the current JSON value.

Methods

Clone()

Gets a JsonElement that can be safely stored beyond the lifetime of the original JsonDocument.

EnumerateArray()

Gets an enumerator to enumerate the values in the JSON array represented by this JsonElement.

EnumerateObject()

Gets an enumerator to enumerate the properties in the JSON object represented by this JsonElement.

GetArrayLength()

Gets the number of values contained within the current array value.

GetBoolean()

Gets the value of the element as a Boolean.

GetByte()

Gets the current JSON number as a Byte.

GetBytesFromBase64()

Gets the value of the element as a byte array.

GetDateTime()

Gets the value of the element as a DateTime.

GetDateTimeOffset()

Gets the value of the element as a DateTimeOffset.

GetDecimal()

Gets the current JSON number as a Decimal.

GetDouble()

Gets the current JSON number as a Double.

GetGuid()

Gets the value of the element as a Guid.

GetInt16()

Gets the current JSON number as an Int16.

GetInt32()

Gets the current JSON number as an Int32.

GetInt64()

Gets the current JSON number as an Int64.

GetProperty(ReadOnlySpan<Byte>)

Gets a JsonElement representing the value of a required property identified by utf8PropertyName.

GetProperty(ReadOnlySpan<Char>)

Gets a JsonElement representing the value of a required property identified by propertyName.

GetProperty(String)

Gets a JsonElement representing the value of a required property identified by propertyName.

GetRawText()

Gets a string that represents the original input data backing this value.

GetSByte()

Gets the current JSON number as an SByte.

GetSingle()

Gets the current JSON number as a Single.

GetString()

Gets the value of the element as a String.

GetUInt16()

Gets the current JSON number as a UInt16.

GetUInt32()

Gets the current JSON number as a UInt32.

GetUInt64()

Gets the current JSON number as a UInt64.

ParseValue(Utf8JsonReader)

Parses one JSON value (including objects or arrays) from the provided reader.

ToString()

Gets a string representation for the current value appropriate to the value type.

TryGetByte(Byte)

Attempts to represent the current JSON number as a Byte.

TryGetBytesFromBase64(Byte[])

Attempts to represent the current JSON string as a byte array, assuming that it is Base64 encoded.

TryGetDateTime(DateTime)

Attempts to represent the current JSON string as a DateTime.

TryGetDateTimeOffset(DateTimeOffset)

Attempts to represent the current JSON string as a DateTimeOffset.

TryGetDecimal(Decimal)

Attempts to represent the current JSON number as a Decimal.

TryGetDouble(Double)

Attempts to represent the current JSON number as a Double.

TryGetGuid(Guid)

Attempts to represent the current JSON string as a Guid.

TryGetInt16(Int16)

Attempts to represent the current JSON number as an Int16.

TryGetInt32(Int32)

Attempts to represent the current JSON number as an Int32.

TryGetInt64(Int64)

Attempts to represent the current JSON number as a Int64.

TryGetProperty(ReadOnlySpan<Byte>, JsonElement)

Looks for a property named utf8PropertyName in the current object, returning a value that indicates whether or not such a property exists. When the property exists, the method assigns its value to the value argument.

TryGetProperty(ReadOnlySpan<Char>, JsonElement)

Looks for a property named propertyName in the current object, returning a value that indicates whether or not such a property exists. When the property exists, the method assigns its value to the value argument.

TryGetProperty(String, JsonElement)

Looks for a property named propertyName in the current object, returning a value that indicates whether or not such a property exists. When the property exists, its value is assigned to the value argument.

TryGetSByte(SByte)

Attempts to represent the current JSON number as an SByte.

TryGetSingle(Single)

Attempts to represent the current JSON number as a Single.

TryGetUInt16(UInt16)

Attempts to represent the current JSON number as a UInt16.

TryGetUInt32(UInt32)

Attempts to represent the current JSON number as a UInt32.

TryGetUInt64(UInt64)

Attempts to represent the current JSON number as a UInt64.

TryParseValue(Utf8JsonReader, Nullable<JsonElement>)

Attempts to parse one JSON value (including objects or arrays) from the provided reader.

ValueEquals(ReadOnlySpan<Byte>)

Compares the text represented by a UTF8-encoded byte span to the string value of this element.

ValueEquals(ReadOnlySpan<Char>)

Compares a specified read-only character span to the string value of this element.

ValueEquals(String)

Compares a specified string to the string value of this element.

WriteTo(Utf8JsonWriter)

Writes the element to the specified writer as a JSON value.

Extension Methods

Deserialize(JsonElement, JsonTypeInfo)

Converts the JsonElement representing a single JSON value into an instance specified by the jsonTypeInfo.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Converts the JsonElement representing a single JSON value into a returnType.

Deserialize(JsonElement, Type, JsonSerializerContext)

Converts the JsonElement representing a single JSON value into a returnType.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Converts the JsonElement representing a single JSON value into a TValue.

Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)

Converts the JsonElement representing a single JSON value into a TValue.

Applies to