JsonSerializer.Deserialize Method

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Overloads

Deserialize(Stream, JsonTypeInfo)	Reads the UTF-8 encoded text representing a single JSON value into an instance specified by the jsonTypeInfo. The Stream will be read to completion.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Reads one JSON value (including objects or arrays) from the provided reader into a returnType.
Deserialize(JsonNode, Type, JsonSerializerContext)	Converts the JsonNode representing a single JSON value into a returnType.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Converts the JsonNode representing a single JSON value into a returnType.
Deserialize(JsonElement, Type, JsonSerializerContext)	Converts the JsonElement representing a single JSON value into a returnType.
Deserialize(JsonElement, Type, JsonSerializerOptions)	Converts the JsonElement representing a single JSON value into a returnType.
Deserialize(JsonDocument, Type, JsonSerializerContext)	Converts the JsonDocument representing a single JSON value into a returnType.
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Converts the JsonDocument representing a single JSON value into a returnType.
Deserialize(String, Type, JsonSerializerContext)	Parses the text representing a single JSON value into a returnType.
Deserialize(String, Type, JsonSerializerOptions)	Parses the text representing a single JSON value into an instance of a specified type.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	Parses the text representing a single JSON value into a returnType.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	Parses the text representing a single JSON value into an instance of a specified type.
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	Reads one JSON value (including objects or arrays) from the provided reader and converts it into an instance of a specified type.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Parses the UTF-8 encoded text representing a single JSON value into an instance of a specified type.
Deserialize(Stream, Type, JsonSerializerContext)	Reads the UTF-8 encoded text representing a single JSON value into a returnType. The Stream will be read to completion.
Deserialize(Stream, Type, JsonSerializerOptions)	Reads the UTF-8 encoded text representing a single JSON value into a returnType. The Stream will be read to completion.
Deserialize(Utf8JsonReader, JsonTypeInfo)	Reads one JSON value (including objects or arrays) from the provided reader into an instance specified by the jsonTypeInfo.
Deserialize(JsonNode, JsonTypeInfo)	Converts the JsonNode representing a single JSON value into an instance specified by the jsonTypeInfo.
Deserialize(JsonElement, JsonTypeInfo)	Converts the JsonElement representing a single JSON value into an instance specified by the jsonTypeInfo.
Deserialize(JsonDocument, JsonTypeInfo)	Converts the JsonDocument representing a single JSON value into an instance specified by the jsonTypeInfo.
Deserialize(String, JsonTypeInfo)	Parses the text representing a single JSON value into an instance specified by the jsonTypeInfo.
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Parses the text representing a single JSON value into an instance specified by the jsonTypeInfo.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Parses the UTF-8 encoded text representing a single JSON value into a returnType.
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Parses the UTF-8 encoded text representing a single JSON value into an instance specified by the jsonTypeInfo.
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.
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Reads one JSON value (including objects or arrays) from the provided reader into a TValue.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Converts the JsonNode representing a single JSON value into a TValue.
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	Reads one JSON value (including objects or arrays) from the provided reader into an instance of the type specified by a generic type parameter.
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	Converts the JsonDocument representing a single JSON value into a TValue.
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Converts the JsonNode representing a single JSON value into a TValue.
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Converts the JsonDocument representing a single JSON value into a TValue.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Parses the text representing a single JSON value into a TValue.
Deserialize<TValue>(String, JsonSerializerOptions)	Parses the text representing a single JSON value into an instance of the type specified by a generic type parameter.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Parses the text representing a single JSON value into an instance of the type specified by a generic type parameter.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	Parses the UTF-8 encoded text representing a single JSON value into a TValue.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	Parses the UTF-8 encoded text representing a single JSON value into an instance of the type specified by a generic type parameter.
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	Reads the UTF-8 encoded text representing a single JSON value into a TValue. The Stream will be read to completion.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Reads the UTF-8 encoded text representing a single JSON value into a TValue. The Stream will be read to completion.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Parses the text representing a single JSON value into a TValue.

Deserialize(Stream, JsonTypeInfo)

Source:

JsonSerializer.Read.Stream.cs

Reads the UTF-8 encoded text representing a single JSON value into an instance specified by the jsonTypeInfo. The Stream will be read to completion.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Object

Parameters

utf8Json

Stream

JSON data to parse.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

ArgumentNullException

utf8Json or jsonTypeInfo is null.

JsonException

The JSON is invalid, or there is remaining data in the Stream.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

Reads one JSON value (including objects or arrays) from the provided reader into a returnType.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object

Parameters

reader

Utf8JsonReader

The reader to read.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType or context is null.

JsonException

The JSON is invalid, returnType is not compatible with the JSON, or a value could not be read from the reader.

ArgumentException

reader is using unsupported options.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method on the provided context did not return a compatible JsonTypeInfo for returnType.

Remarks

If the TokenType property of reader is PropertyName or None, the reader will be advanced by one call to Read() to determine the start of the value.

Upon completion of this method, reader is positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called.

This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method.

The JsonReaderOptions used to create the instance of the Utf8JsonReader take precedence over the JsonSerializerOptions when they conflict. Hence, AllowTrailingCommas, MaxDepth, and CommentHandling are used while reading.

Deserialize(JsonNode, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Node.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Object

Parameters

node

JsonNode

The JsonNode to convert.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType is null.

-or-

context is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method of the provided context returns null for the type to convert.

Deserialize(JsonNode, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Node.cs

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

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

node

JsonNode

The JsonNode to convert.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

Object

A returnType representation of the JSON value.

Exceptions

JsonException

returnType is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Deserialize(JsonElement, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Element.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Object

Parameters

element

JsonElement

The JsonElement to convert.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType is null.

-or-

context is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method of the provided context returns null for the type to convert.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Element.cs

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

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

element

JsonElement

The JsonElement to convert.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType is null.

JsonException

returnType is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Deserialize(JsonDocument, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Document.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Object

Parameters

document

JsonDocument

The JsonDocument to convert.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

document is null.

-or-

returnType is null.

-or-

context is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method of the provided context returns null for the type to convert.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Document.cs

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

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

document

JsonDocument

The JsonDocument to convert.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

document or returnType is null.

JsonException

returnType is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Deserialize(String, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into a returnType.

public:
 static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object

Parameters

json

String

JSON text to parse.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

json or returnType is null.

-or-

context is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method of the provided context returns null for the type to convert.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

Deserialize(String, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into an instance of a specified type.

public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

json

String

The JSON text to parse.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

json or returnType is null.

JsonException

The JSON is invalid.

-or-

TValue is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

For more information, see How to serialize and deserialize JSON.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into a returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object

Parameters

json

ReadOnlySpan<Char>

JSON text to parse.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

json or returnType is null.

-or-

context is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method of the provided context returns null for the type to convert.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into an instance of a specified type.

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

json

ReadOnlySpan<Char>

The JSON text to parse.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

There is remaining data in the span beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Remarks

Using a UTF-16 span is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

Reads one JSON value (including objects or arrays) from the provided reader and converts it into an instance of a specified type.

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

reader

Utf8JsonReader

The reader to read the JSON from.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the serializer behavior during reading.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

A value could not be read from the reader.

ArgumentException

reader is using unsupported options.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Remarks

If the TokenType property of reader is JsonTokenType.PropertyName or JsonTokenType.None, the reader will be advanced by one call to Utf8JsonReader.Read() to determine the start of the value.

Upon completion of this method, reader will be positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called.

This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method.

The JsonReaderOptions used to create the instance of the Utf8JsonReader take precedence over the JsonSerializerOptions when they conflict. Hence, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth, and JsonReaderOptions.CommentHandling are used while reading.

For more information, see How to serialize and deserialize JSON.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Span.cs

Parses the UTF-8 encoded text representing a single JSON value into an instance of a specified type.

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

utf8Json

ReadOnlySpan<Byte>

The JSON text to parse.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType is null.

JsonException

The JSON is invalid.

-or-

returnType is not compatible with the JSON.

-or-

There is remaining data in the span beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Remarks

For more information, see How to serialize and deserialize JSON.

Deserialize(Stream, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Stream.cs

Reads the UTF-8 encoded text representing a single JSON value into a returnType. The Stream will be read to completion.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Object

Parameters

utf8Json

Stream

JSON data to parse.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

utf8Json, returnType, or context is null.

JsonException

The JSON is invalid, the returnType is not compatible with the JSON, or there is remaining data in the Stream.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method on the provided context did not return a compatible JsonTypeInfo for returnType.

Deserialize(Stream, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Stream.cs

Reads the UTF-8 encoded text representing a single JSON value into a returnType. The Stream will be read to completion.

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parameters

utf8Json

Stream

JSON data to parse.

returnType

Type

The type of the object to convert to and return.

options

JsonSerializerOptions

Options to control the behavior during reading.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

utf8Json or returnType is null.

JsonException

The JSON is invalid, the returnType is not compatible with the JSON, or there is remaining data in the Stream.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

Deserialize(Utf8JsonReader, JsonTypeInfo)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

Reads one JSON value (including objects or arrays) from the provided reader into an instance specified by the jsonTypeInfo.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Object

Parameters

reader

Utf8JsonReader

The reader to read.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

JsonException

The JSON is invalid, jsonTypeInfo is not compatible with the JSON, or a value could not be read from the reader.

ArgumentException

reader is using unsupported options.

Remarks

If the TokenType property of reader is PropertyName or None, the reader will be advanced by one call to Read() to determine the start of the value.

Upon completion of this method, reader will be positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called.

This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method.

The JsonReaderOptions used to create the instance of the Utf8JsonReader take precedence over the JsonSerializerOptions when they conflict. Hence, AllowTrailingCommas, MaxDepth, and CommentHandling are used while reading.

Deserialize(JsonNode, JsonTypeInfo)

Source:

JsonSerializer.Read.Node.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Object

Parameters

node

JsonNode

The JsonNode to convert.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

ArgumentNullException

jsonTypeInfo is null.

Deserialize(JsonElement, JsonTypeInfo)

Source:

JsonSerializer.Read.Element.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As Object

Parameters

element

JsonElement

The JsonElement to convert.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

ArgumentNullException

jsonTypeInfo is null.

Deserialize(JsonDocument, JsonTypeInfo)

Source:

JsonSerializer.Read.Document.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As Object

Parameters

document

JsonDocument

The JsonDocument to convert.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

ArgumentNullException

document is null.

-or-

jsonTypeInfo is null.

Deserialize(String, JsonTypeInfo)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into an instance specified by the jsonTypeInfo.

public:
 static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Object

Parameters

json

String

JSON text to parse.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

ArgumentNullException

json is null.

-or-

jsonTypeInfo is null.

JsonException

The JSON is invalid.

-or-

There is remaining data in the string beyond a single JSON value.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into an instance specified by the jsonTypeInfo.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Object

Parameters

json

ReadOnlySpan<Char>

JSON text to parse.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

ArgumentNullException

jsonTypeInfo is null.

JsonException

The JSON is invalid.

-or-

There is remaining data in the string beyond a single JSON value.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Span.cs

Parses the UTF-8 encoded text representing a single JSON value into a returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object

Parameters

utf8Json

ReadOnlySpan<Byte>

JSON text to parse.

returnType

Type

The type of the object to convert to and return.

context

JsonSerializerContext

A metadata provider for serializable types.

Returns

Object

A returnType representation of the JSON value.

Exceptions

ArgumentNullException

returnType is null.

JsonException

The JSON is invalid, returnType is not compatible with the JSON, or there is remaining data in the Stream.

NotSupportedException

There is no compatible JsonConverter for returnType or its serializable members.

InvalidOperationException

The GetTypeInfo(Type) method on the provided context did not return a compatible JsonTypeInfo for returnType.

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Source:

JsonSerializer.Read.Span.cs

Parses the UTF-8 encoded text representing a single JSON value into an instance specified by the jsonTypeInfo.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object

Parameters

utf8Json

ReadOnlySpan<Byte>

JSON text to parse.

jsonTypeInfo

JsonTypeInfo

Metadata about the type to convert.

Returns

Object

A jsonTypeInfo representation of the JSON value.

Exceptions

JsonException

The JSON is invalid, or there is remaining data in the buffer.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Source:

JsonSerializer.Read.Element.cs

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

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

element

JsonElement

The JsonElement to convert.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

JsonException

TValue is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

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

Source:

JsonSerializer.Read.Element.cs

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

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

element

JsonElement

The JsonElement to convert.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

jsonTypeInfo is null.

JsonException

TValue is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

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

Source:

JsonSerializer.Read.Utf8JsonReader.cs

Reads one JSON value (including objects or arrays) from the provided reader into a TValue.

public:
generic <typename TValue>
 static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

reader

Utf8JsonReader

The reader to read.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

JsonException

The JSON is invalid, TValue is not compatible with the JSON, or a value could not be read from the reader.

ArgumentException

reader is using unsupported options.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Remarks

If the TokenType property of reader is PropertyName or None, the reader will be advanced by one call to Read() to determine the start of the value.

Upon completion of this method, reader is positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called.

This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method.

The JsonReaderOptions used to create the instance of the Utf8JsonReader take precedence over the JsonSerializerOptions when they conflict. Hence, AllowTrailingCommas, MaxDepth, and CommentHandling are used while reading.

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

Source:

JsonSerializer.Read.Node.cs

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

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

node

JsonNode

The JsonNode to convert.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

jsonTypeInfo is null.

JsonException

TValue is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

Reads one JSON value (including objects or arrays) from the provided reader into an instance of the type specified by a generic type parameter.

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The target type of the JSON value.

Parameters

reader

Utf8JsonReader

The reader to read the JSON from.

options

JsonSerializerOptions

Options to control serializer behavior during reading.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

JsonException

The JSON is invalid.

-or-

TValue is not compatible with the JSON.

-or-

A value could not be read from the reader.

ArgumentException

reader uses unsupported options.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Remarks

If the TokenType property of reader is JsonTokenType.PropertyName or JsonTokenType.None, the reader will be advanced by one call to Utf8JsonReader.Read() to determine the start of the value.

Upon completion of this method, reader will be positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called.

This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method.

The JsonReaderOptions used to create the instance of the Utf8JsonReader take precedence over the JsonSerializerOptions when they conflict. Hence, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth, and JsonReaderOptions.CommentHandling are used while reading.

For more information, see How to serialize and deserialize JSON.

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

Source:

JsonSerializer.Read.Document.cs

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

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

document

JsonDocument

The JsonDocument to convert.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

document is null.

-or-

jsonTypeInfo is null.

JsonException

TValue is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Source:

JsonSerializer.Read.Node.cs

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

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

node

JsonNode

The JsonNode to convert.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

JsonException

TValue is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Source:

JsonSerializer.Read.Document.cs

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

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

document

JsonDocument

The JsonDocument to convert.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

document is null.

JsonException

TValue is not compatible with the JSON.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into a TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

json

ReadOnlySpan<Char>

JSON text to parse.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

json is null.

-or-

jsonTypeInfo is null.

JsonException

The JSON is invalid.

-or-

TValue is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

Deserialize<TValue>(String, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into an instance of the type specified by a generic type parameter.

public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The target type of the JSON value.

Parameters

json

String

The JSON text to parse.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

json is null.

JsonException

The JSON is invalid.

-or-

TValue is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

For more information, see How to serialize and deserialize JSON.

Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into an instance of the type specified by a generic type parameter.

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

json

ReadOnlySpan<Char>

The JSON text to parse.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

JsonException

The JSON is invalid.

-or-

TValue is not compatible with the JSON.

-or-

There is remaining data in the span beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Remarks

Using a UTF-16 span is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.Span.cs

Parses the UTF-8 encoded text representing a single JSON value into a TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

utf8Json

ReadOnlySpan<Byte>

JSON text to parse.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

JsonException

The JSON is invalid, TValue is not compatible with the JSON, or there is remaining data in the Stream.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)

Source:

JsonSerializer.Read.Span.cs

Parses the UTF-8 encoded text representing a single JSON value into an instance of the type specified by a generic type parameter.

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The target type of the UTF-8 encoded text.

Parameters

utf8Json

ReadOnlySpan<Byte>

The JSON text to parse.

options

JsonSerializerOptions

Options to control the behavior during parsing.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

JsonException

The JSON is invalid.

-or-

TValue is not compatible with the JSON.

-or-

There is remaining data in the span beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Remarks

For more information, see How to serialize and deserialize JSON.

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

Source:

JsonSerializer.Read.Stream.cs

Reads the UTF-8 encoded text representing a single JSON value into a TValue. The Stream will be read to completion.

public:
generic <typename TValue>
 static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

utf8Json

Stream

JSON data to parse.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

utf8Json or jsonTypeInfo is null.

JsonException

The JSON is invalid, TValue is not compatible with the JSON, or there is remaining data in the Stream.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Deserialize<TValue>(Stream, JsonSerializerOptions)

Source:

JsonSerializer.Read.Stream.cs

Reads the UTF-8 encoded text representing a single JSON value into a TValue. The Stream will be read to completion.

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

utf8Json

Stream

JSON data to parse.

options

JsonSerializerOptions

Options to control the behavior during reading.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

utf8Json is null.

JsonException

The JSON is invalid, TValue is not compatible with the JSON, or there is remaining data in the Stream.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

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

Source:

JsonSerializer.Read.String.cs

Parses the text representing a single JSON value into a TValue.

public:
generic <typename TValue>
 static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Type Parameters

TValue

The type to deserialize the JSON value into.

Parameters

json

String

JSON text to parse.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata about the type to convert.

Returns

TValue

A TValue representation of the JSON value.

Exceptions

ArgumentNullException

json is null.

-or-

jsonTypeInfo is null.

JsonException

The JSON is invalid.

-or-

TValue is not compatible with the JSON.

-or-

There is remaining data in the string beyond a single JSON value.

NotSupportedException

There is no compatible JsonConverter for TValue or its serializable members.

Remarks

Using a String is not as efficient as using the UTF-8 methods since the implementation natively uses UTF-8.