JsonSerializer.SerializeAsync 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
| SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
| SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
| SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken) |
Secara asinkron mengonversi nilai jenis tertentu menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke aliran yang ditentukan. |
| SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
| SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken) |
Secara asinkron mengonversi nilai jenis yang ditentukan oleh parameter jenis generik menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke aliran. |
SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- value
- Object
Nilai yang akan dikonversi.
- inputType
- Type
Jenis yang akan dikonversi value .
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
- cancellationToken
- CancellationToken
CancellationToken yang dapat digunakan untuk membatalkan operasi tulis.
Mengembalikan
Tugas yang mewakili operasi tulis asinkron.
Pengecualian
inputType tidak kompatibel dengan value.
utf8Json, inputType, atau context adalah null.
Tidak ada yang kompatibel JsonConverter untuk inputType atau anggotanya yang dapat diserialisasikan.
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 Serialize(Stream, Object, Type, JsonSerializerContext).
Berlaku untuk
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- value
- Object
Nilai yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
- cancellationToken
- CancellationToken
CancellationToken yang dapat digunakan untuk membatalkan operasi tulis.
Mengembalikan
Tugas yang mewakili operasi tulis asinkron.
Pengecualian
utf8Jsonadalah null.
value tidak cocok dengan jenis jsonTypeInfo.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Berlaku untuk
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)
Secara asinkron mengonversi nilai jenis tertentu menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke aliran yang ditentukan.
public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- utf8Json
- Stream
Aliran UTF-8 untuk ditulis.
- value
- Object
Nilai yang akan dikonversi.
- inputType
- Type
Jenis yang akan dikonversi value .
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku serialisasi.
- cancellationToken
- CancellationToken
Token yang dapat digunakan untuk membatalkan operasi tulis.
Mengembalikan
Tugas yang mewakili operasi tulis asinkron.
Pengecualian
inputType tidak kompatibel dengan value.
utf8Json atau inputType adalah null.
Tidak ada yang kompatibel JsonConverter untuk inputType 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 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 Serialize(Stream, Object, Type, JsonSerializerOptions).
Berlaku untuk
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As TaskJenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- value
- TValue
Nilai yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata tentang jenis yang akan dikonversi.
- cancellationToken
- CancellationToken
CancellationToken yang dapat digunakan untuk membatalkan operasi tulis.
Mengembalikan
Tugas yang mewakili operasi tulis asinkron.
Pengecualian
utf8Jsonadalah null.
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
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)
Secara asinkron mengonversi nilai jenis yang ditentukan oleh parameter jenis generik menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke aliran.
public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskJenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- utf8Json
- Stream
Aliran UTF-8 untuk ditulis.
- value
- TValue
Nilai yang akan dikonversi.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku serialisasi.
- cancellationToken
- CancellationToken
Token yang dapat digunakan untuk membatalkan operasi tulis.
Mengembalikan
Tugas yang mewakili operasi tulis asinkron.
Pengecualian
utf8Jsonadalah null.
Tidak ada yang kompatibel JsonConverter untuk TValue 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.
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