JsonSerializer.DeserializeAsync Methode

Definition

Überlädt

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz eines angegebenen Typs.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a specified type. Der Datenstrom wird vollständig gelesen.The stream will be read to completion.

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Kiest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a type specified by a generic type parameter. Der Datenstrom wird vollständig gelesen.The stream will be read to completion.

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz eines angegebenen Typs.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a specified type. Der Datenstrom wird vollständig gelesen.The stream will be read to completion.

public static System.Threading.Tasks.ValueTask<object> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Shared Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = null, Optional cancellationToken As CancellationToken = null) As ValueTask(Of Object)

Parameter

utf8Json
Stream

Die zu analysierenden JSON-Daten.The JSON data to parse.

returnType
Type

Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.The type of the object to convert to and return.

options
JsonSerializerOptions

Optionen zum Steuern des Verhaltens während des Lesevorgangs.Options to control the behavior during reading.

cancellationToken
CancellationToken

Ein Abbruchtoken, das verwendet werden kann, um den Lesevorgang abzubrechen.A cancellation token that may be used to cancel the read operation.

Gibt zurück

ValueTask<Object>

Eine returnType-Darstellung des JSON-Werts.A returnType representation of the JSON value.

Ausnahmen

utf8Json oder returnType ist null.utf8Json or returnType is null.

Der JSON-Code ist ungültig.The JSON is invalid.

Oder-or-

TValue ist nicht mit dem JSON-Code kompatibel.TValue is not compatible with the JSON.

Oder-or-

Es verbleiben Daten im Datenstrom.There is remaining data in the stream.

Es ist kein kompatibler JsonConverter für returnType oder seine serialisierbaren Member vorhanden.There is no compatible JsonConverter for returnType or its serializable members.

Hinweise

Weitere Informationen finden Sie unter Gewusst wie: Serialisieren und Deserialisieren von JSON.For more information, see How to serialize and deserialize JSON.

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Kiest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a type specified by a generic type parameter. Der Datenstrom wird vollständig gelesen.The stream will be read to completion.

public static System.Threading.Tasks.ValueTask<TValue> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Shared Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = null, Optional cancellationToken As CancellationToken = null) As ValueTask(Of TValue)

Typparameter

TValue

Der Zieltyp des JSON-Werts.The target type of the JSON value.

Parameter

utf8Json
Stream

Die zu analysierenden JSON-Daten.The JSON data to parse.

options
JsonSerializerOptions

Optionen zum Steuern des Verhaltens während des Lesevorgangs.Options to control the behavior during reading.

cancellationToken
CancellationToken

Ein Token, das verwendet werden kann, um den Lesevorgang abzubrechen.A token that may be used to cancel the read operation.

Gibt zurück

ValueTask<TValue>

Eine TValue-Darstellung des JSON-Werts.A TValue representation of the JSON value.

Ausnahmen

Der JSON-Code ist ungültig.The JSON is invalid.

Oder-or-

TValue ist nicht mit dem JSON-Code kompatibel.TValue is not compatible with the JSON.

Oder-or-

Es verbleiben Daten im Datenstrom.There is remaining data in the stream.

Es ist kein kompatibler JsonConverter für TValue oder seine serialisierbaren Member vorhanden.There is no compatible JsonConverter for TValue or its serializable members.

Hinweise

Weitere Informationen finden Sie unter Gewusst wie: Serialisieren und Deserialisieren von JSON.For more information, see How to serialize and deserialize JSON.

Gilt für: