JsonSerializer.DeserializeAsync Yöntem

Tanım

Aşırı Yüklemeler

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Tek bir JSON değerini belirtilen tür örneğine gösteren UTF-8 kodlu metni zaman uyumsuz olarak okur.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a specified type. Akış tamamlanmayacak şekilde okunacak.The stream will be read to completion.

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Genel tür parametresiyle belirtilen bir türün örneğine tek bir JSON değerini temsil eden UTF-8 kodlu metni zaman uyumsuz olarak okur.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a type specified by a generic type parameter. Akış tamamlanmayacak şekilde okunacak.The stream will be read to completion.

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Tek bir JSON değerini belirtilen tür örneğine gösteren UTF-8 kodlu metni zaman uyumsuz olarak okur.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a specified type. Akış tamamlanmayacak şekilde okunacak.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);
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 = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

Parametreler

utf8Json
Stream

Ayrıştırılacak JSON verileri.The JSON data to parse.

returnType
Type

Dönüştürülecek ve döndürülecek nesnenin türü.The type of the object to convert to and return.

options
JsonSerializerOptions

Okuma sırasında davranışı denetleme seçenekleri.Options to control the behavior during reading.

cancellationToken
CancellationToken

Okuma işlemini iptal etmek için kullanılabilecek bir iptal belirteci.A cancellation token that may be used to cancel the read operation.

Döndürülenler

ValueTask<Object>

returnTypeJSON değerinin temsili.A returnType representation of the JSON value.

Özel durumlar

utf8Json ya returnType da null .utf8Json or returnType is null.

JSON geçersiz.The JSON is invalid.

-veya--or-

TValue JSON ile uyumlu değil.TValue is not compatible with the JSON.

-veya--or-

Akışta kalan veriler var.There is remaining data in the stream.

JsonConverter returnType Veya seri hale getirilebilir üyeleri için uyumlu değildir.There is no compatible JsonConverter for returnType or its serializable members.

Açıklamalar

Daha fazla bilgi için bkz. JSON serileştirme ve seri durumdan çıkarma.For more information, see How to serialize and deserialize JSON.

Şunlara uygulanır

Ürün Introduced

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Genel tür parametresiyle belirtilen bir türün örneğine tek bir JSON değerini temsil eden UTF-8 kodlu metni zaman uyumsuz olarak okur.Asynchronously reads the UTF-8 encoded text representing a single JSON value into an instance of a type specified by a generic type parameter. Akış tamamlanmayacak şekilde okunacak.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);
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 = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

Tür Parametreleri

TValue

JSON değerinin hedef türü.The target type of the JSON value.

Parametreler

utf8Json
Stream

Ayrıştırılacak JSON verileri.The JSON data to parse.

options
JsonSerializerOptions

Okuma sırasında davranışı denetleme seçenekleri.Options to control the behavior during reading.

cancellationToken
CancellationToken

Okuma işlemini iptal etmek için kullanılabilecek bir belirteç.A token that may be used to cancel the read operation.

Döndürülenler

ValueTask<TValue>

TValueJSON değerinin temsili.A TValue representation of the JSON value.

Özel durumlar

JSON geçersiz.The JSON is invalid.

-veya--or-

TValue JSON ile uyumlu değil.TValue is not compatible with the JSON.

-veya--or-

Akışta kalan veriler var.There is remaining data in the stream.

JsonConverter TValue Veya seri hale getirilebilir üyeleri için uyumlu değildir.There is no compatible JsonConverter for TValue or its serializable members.

utf8Jsonnull.utf8Jsonis null.

Açıklamalar

Daha fazla bilgi için bkz. JSON serileştirme ve seri durumdan çıkarma.For more information, see How to serialize and deserialize JSON.

Şunlara uygulanır

Ürün Introduced