JsonSerializer.DeserializeAsync Metode
Definisi
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, Type, JsonSerializerContext, CancellationToken) |
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam |
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh |
| 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<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam |
| 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, Type, JsonSerializerContext, CancellationToken)
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
Representasi returnType nilai JSON.
Pengecualian
utf8Json, returnType, atau context adalah null.
JSON tidak valid, returnType tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) pada yang disediakan context tidak mengembalikan kompatibel JsonTypeInfo untuk returnType.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Metode ini disimpan dalam tugas yang menampilkan 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(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.
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
Representasi jsonTypeInfo nilai JSON.
Pengecualian
utf8Json atau jsonTypeInfo adalah null.
JSON tidak valid, atau ketika ada data yang tersisa di Stream.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Berlaku untuk
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.
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
Representasi returnType nilai JSON.
Pengecualian
utf8Json atau returnType adalah null.
JSON tidak valid.
-atau-
TValue tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa di aliran.
Tidak ada yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi JSON.
Metode ini disimpan dalam tugas yang menampilkan 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<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
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 ke dalamnya.
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
Representasi TValue nilai JSON.
Pengecualian
utf8Json atau jsonTypeInfo adalah null.
JSON tidak valid, TValue tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada yang kompatibel JsonConverter untuk TValue atau anggotanya yang dapat diserialisasikan.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Berlaku untuk
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.
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
Representasi TValue nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
TValue tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa di aliran.
Tidak ada yang kompatibel JsonConverter untuk TValue atau anggotanya yang dapat diserialisasikan.
utf8Jsonadalah null.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi JSON.
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk