Bagikan melalui

JsonSerializer.DeserializeAsync Metode

  • Referensi

Definisi

Ruang nama:
System.Text.Json
Rakitan:
System.Text.Json.dll
Paket:
System.Text.Json v8.0.5
Paket:
System.Text.Json v9.0.0-rc.2.24473.5

Overload

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo. Stream akan dibaca hingga selesai.
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Secara asinkron membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis tertentu. Aliran akan dibaca hingga selesai.
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue. Stream akan dibaca hingga selesai.
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Secara asinkron membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik. Aliran akan dibaca hingga selesai.

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo. Stream akan dibaca hingga selesai.

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

Parameter

utf8Json
Stream

Data JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

cancellationToken
CancellationToken

CancellationToken yang dapat digunakan untuk membatalkan operasi baca.

Mengembalikan

ValueTask<Object>

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau jsonTypeInfonull.

JsonException

JSON tidak valid, atau ketika ada data yang tersisa di Stream.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Berlaku untuk

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Secara asinkron membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis tertentu. Aliran akan dibaca hingga selesai.

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)
Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

Parameter

utf8Json
Stream

Data JSON yang akan diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama membaca.

cancellationToken
CancellationToken

Token pembatalan yang dapat digunakan untuk membatalkan operasi baca.

Mengembalikan

ValueTask<Object>

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau returnTypenull.

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa di aliran.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Deserialize(Stream, Type, JsonSerializerOptions).

Berlaku untuk

DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.

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

Parameter

utf8Json
Stream

Data JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

cancellationToken
CancellationToken

CancellationToken yang dapat digunakan untuk membatalkan operasi baca.

Mengembalikan

ValueTask<Object>

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

utf8Json, returnType, atau contextnull.

JsonException

JSON tidak valid, returnType tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) pada context yang disediakan tidak mengembalikan JsonTypeInfo yang kompatibel untuk returnType.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Deserialize(Stream, Type, JsonSerializerContext).

Berlaku untuk

DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue. Stream akan dibaca hingga selesai.

public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

utf8Json
Stream

Data JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

cancellationToken
CancellationToken

CancellationToken yang dapat digunakan untuk membatalkan operasi baca.

Mengembalikan

ValueTask<TValue>

Representasi TValue dari nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau jsonTypeInfonull.

JsonException

JSON tidak valid, TValue tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Berlaku untuk

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Secara asinkron membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik. Aliran akan dibaca hingga selesai.

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)
Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

Jenis parameter

TValue

Jenis target dari nilai JSON.

Parameter

utf8Json
Stream

Data JSON yang akan diurai.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama membaca.

cancellationToken
CancellationToken

Token yang dapat digunakan untuk membatalkan operasi baca.

Mengembalikan

ValueTask<TValue>

Representasi TValue dari nilai JSON.

Pengecualian

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa di aliran.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

ArgumentNullException

utf8Json null.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Berlaku untuk