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.Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- 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.Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- 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
utf8Json
adalah 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.Task
Public Shared Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- 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.Task
Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task
Jenis 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
utf8Json
adalah 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.Task
Public Shared Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Jenis 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
utf8Json
adalah 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
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk