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

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

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

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

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

Berlaku untuk

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

Sumber:: JsonSerializer.Read.Stream.cs

Sumber:: JsonSerializer.Read.Stream.cs

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

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

Bagikan melalui

JsonSerializer.DeserializeAsync Metode

Definisi

Overload

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

Parameter

Mengembalikan

Pengecualian

Berlaku untuk

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

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

Jenis parameter

Parameter

Mengembalikan

Pengecualian

Berlaku untuk

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Jenis parameter

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: