JsonSerializer.DeserializeAsync Metoda

Definicja

Przeciążenia

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON do wystąpienia określonego typu.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a specified type. Strumień zostanie odczytany do ukończenia.The stream will be read to completion.

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON do wystąpienia typu określonego przez parametr typu ogólnego.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a type specified by a generic type parameter. Strumień zostanie odczytany do ukończenia.The stream will be read to completion.

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON do wystąpienia określonego typu.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a specified type. Strumień zostanie odczytany do ukończenia.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>

Parametry

utf8Json
Stream

Dane JSON do analizy.The JSON data to parse.

returnType
Type

Typ obiektu do przekonwertowania i zwrócenia.The type of the object to convert to and return.

options
JsonSerializerOptions

Opcje sterujące zachowaniem podczas odczytu.Options to control the behavior during reading.

cancellationToken
CancellationToken

Token anulowania, który może służyć do anulowania operacji odczytu.A cancellation token that may be used to cancel the read operation.

Zwraca

returnType reprezentacja wartości JSON.A returnType representation of the JSON value.

Wyjątki

Parametr utf8Json lub returnType ma wartość null.utf8Json or returnType is null.

KOD JSON jest nieprawidłowy.The JSON is invalid.

lub-or-

TValue nie jest zgodna z formatem JSON.TValue is not compatible with the JSON.

lub-or-

W strumieniu znajdują się pozostałe dane.There is remaining data in the stream.

Uwagi

Aby uzyskać więcej informacji, zobacz jak serializować i deserializować JSON.For more information, see How to serialize and deserialize JSON.

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON do wystąpienia typu określonego przez parametr typu ogólnego.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a type specified by a generic type parameter. Strumień zostanie odczytany do ukończenia.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>

Parametry typu

TValue

Typ docelowy wartości JSON.The target type of the JSON value.

Parametry

utf8Json
Stream

Dane JSON do analizy.The JSON data to parse.

options
JsonSerializerOptions

Opcje sterujące zachowaniem podczas odczytu.Options to control the behavior during reading.

cancellationToken
CancellationToken

Token, który może służyć do anulowania operacji odczytu.A token that may be used to cancel the read operation.

Zwraca

ValueTask<TValue>

TValue reprezentacja wartości JSON.A TValue representation of the JSON value.

Wyjątki

KOD JSON jest nieprawidłowy.The JSON is invalid.

lub-or-

TValue nie jest zgodna z formatem JSON.TValue is not compatible with the JSON.

lub-or-

W strumieniu znajdują się pozostałe dane.There is remaining data in the stream.

Uwagi

Aby uzyskać więcej informacji, zobacz jak serializować i deserializować JSON.For more information, see How to serialize and deserialize JSON.

Dotyczy