JsonSerializer.Serialize 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
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan. |
Serialize(Stream, Object, Type, JsonSerializerContext) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
Serialize(Stream, Object, Type, JsonSerializerOptions) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Menulis representasi JSON dari jenis yang ditentukan kepada penulis yang disediakan. |
Serialize(Object, Type, JsonSerializerOptions) |
Mengonversi nilai jenis tertentu menjadi string JSON. |
Serialize(Stream, Object, JsonTypeInfo) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
Serialize(Object, JsonTypeInfo) |
Mengonversi nilai yang disediakan menjadi String. |
Serialize(Object, Type, JsonSerializerContext) |
Mengonversi nilai yang disediakan menjadi String. |
Serialize<TValue>(TValue, JsonSerializerOptions) |
Mengonversi nilai jenis yang ditentukan oleh parameter jenis generik menjadi string JSON. |
Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Mengonversi nilai yang disediakan menjadi String. |
Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Menulis representasi JSON dari jenis yang ditentukan oleh parameter jenis generik ke penulis yang disediakan. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unit
Public Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, context As JsonSerializerContext)
Parameter
- writer
- Utf8JsonWriter
Penulis JSON untuk ditulis.
- value
- Object
Nilai untuk dikonversi dan ditulis.
- inputType
- Type
Jenis yang akan dikonversi value
.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Pengecualian
inputType
tidak kompatibel dengan value
.
writer
atau inputType
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk inputType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) pengembalian yang disediakan context
null
untuk jenis yang akan dikonversi.
Berlaku untuk
Serialize(Stream, Object, Type, JsonSerializerContext)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unit
Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)
Parameter
- value
- Object
Nilai yang akan dikonversi.
- inputType
- Type
Jenis yang akan dikonversi value
.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Pengecualian
inputType
tidak kompatibel dengan value
.
utf8Json
, inputType
, atau context
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk inputType
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Serialize(Stream, Object, Type, JsonSerializerOptions)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);
static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions -> unit
Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)
Parameter
- value
- Object
Nilai yang akan dikonversi.
- inputType
- Type
Jenis yang akan dikonversi value
.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku konversi.
Pengecualian
inputType
tidak kompatibel dengan value
.
utf8Json
atau inputType
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk inputType
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Serialize : System.Text.Json.Utf8JsonWriter * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unit
Public Sub Serialize (writer As Utf8JsonWriter, value As Object, jsonTypeInfo As JsonTypeInfo)
Parameter
- writer
- Utf8JsonWriter
Penulis untuk menulis.
- value
- Object
Nilai untuk dikonversi dan ditulis.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Pengecualian
writer
atau jsonTypeInfo
adalah null
.
value
tidak cocok dengan jenis jsonTypeInfo
.
Berlaku untuk
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Menulis representasi JSON dari jenis yang ditentukan kepada penulis yang disediakan.
public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);
public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);
static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unit
Public Shared Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)
Public Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)
Parameter
- writer
- Utf8JsonWriter
Penulis JSON untuk menulis.
- value
- Object
Nilai untuk dikonversi dan ditulis.
- inputType
- Type
Jenis yang akan dikonversi value
.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku serialisasi.
Pengecualian
inputType
tidak kompatibel dengan value
writer
atau inputType
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk inputType
atau anggotanya yang dapat diserialisasikan.
Keterangan
yang JsonWriterOptions digunakan untuk membuat instans yang Utf8JsonWriter diutamakan daripada JsonSerializerOptions ketika mereka berkonflik. Oleh karena itu, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidation, dan JsonWriterOptions.Encoder digunakan saat menulis.
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi JSON.
Berlaku untuk
Serialize(Object, Type, JsonSerializerOptions)
Mengonversi nilai jenis tertentu menjadi string JSON.
public static string Serialize (object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);
public static string Serialize (object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);
static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> string
Public Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String
Public Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String
Parameter
- value
- Object
Nilai yang akan dikonversi.
- inputType
- Type
Jenis yang akan dikonversi value
.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku konversi.
Mengembalikan
Representasi string JSON dari nilai .
Pengecualian
inputType
tidak kompatibel dengan value
.
inputType
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk inputType
atau anggotanya yang dapat diserialisasikan.
Keterangan
String Menggunakan tidak seefisien menggunakan pengodean UTF-8 karena implementasinya secara internal menggunakan UTF-8. Lihat juga SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) dan SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi JSON.
Berlaku untuk
Serialize(Stream, Object, JsonTypeInfo)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static void Serialize (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Serialize : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unit
Public Sub Serialize (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo)
Parameter
- value
- Object
Nilai yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Pengecualian
utf8Json
adalah null
.
value
tidak cocok dengan jenis jsonTypeInfo
.
Berlaku untuk
Serialize(Object, JsonTypeInfo)
Mengonversi nilai yang disediakan menjadi String.
public:
static System::String ^ Serialize(System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static string Serialize (object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Serialize : obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> string
Public Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As String
Parameter
- value
- Object
Nilai yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi String nilai.
Pengecualian
jsonTypeInfo
adalah null
.
value
tidak cocok dengan jenis jsonTypeInfo
.
Keterangan
String Menggunakan tidak seefisien menggunakan pengodean UTF-8 karena implementasinya secara internal menggunakan UTF-8. Lihat juga SerializeToUtf8Bytes(Object, JsonTypeInfo) dan SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Berlaku untuk
Serialize(Object, Type, JsonSerializerContext)
Mengonversi nilai yang disediakan menjadi String.
public:
static System::String ^ Serialize(System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static string Serialize (object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Serialize : obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> string
Public Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As String
Parameter
- value
- Object
Nilai yang akan dikonversi.
- inputType
- Type
Jenis yang akan dikonversi value
.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi String nilai.
Pengecualian
Tidak ada yang kompatibel JsonConverter untuk inputType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) pengembalian yang disediakan context
null
untuk jenis yang akan dikonversi.
inputType
atau context
adalah null
.
Keterangan
String Menggunakan tidak seefisien menggunakan pengodean UTF-8, karena implementasinya secara internal menggunakan UTF-8. SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) Lihat juga dan SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Berlaku untuk
Serialize<TValue>(TValue, JsonSerializerOptions)
Mengonversi nilai jenis yang ditentukan oleh parameter jenis generik menjadi string JSON.
public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions? options = default);
public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions options = default);
static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> string
Public Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String
Public Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String
Jenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- value
- TValue
Nilai yang akan dikonversi.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku serialisasi.
Mengembalikan
Representasi string JSON dari nilai.
Pengecualian
Tidak ada yang kompatibel JsonConverter untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
String Menggunakan tidak seefisien menggunakan pengodean UTF-8 karena implementasi secara internal menggunakan UTF-8. Lihat juga SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) dan SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi JSON.
Berlaku untuk
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Mengonversi nilai yang disediakan menjadi String.
public:
generic <typename TValue>
static System::String ^ Serialize(TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static string Serialize<TValue> (TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Serialize : 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> string
Public Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As String
Jenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- value
- TValue
Nilai yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi String nilai.
Pengecualian
Tidak ada yang kompatibel JsonConverter untuk TValue
atau anggotanya yang dapat diserialisasikan.
jsonTypeInfo
adalah null
.
Keterangan
String Menggunakan tidak seefisien menggunakan pengodean UTF-8 karena implementasi secara internal menggunakan UTF-8. Lihat juga SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) dan SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
Berlaku untuk
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);
static member Serialize : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions -> unit
Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing)
Jenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- value
- TValue
Nilai yang akan dikonversi.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku konversi.
Pengecualian
utf8Json
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Mengonversi nilai yang disediakan menjadi teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
public:
generic <typename TValue>
static void Serialize(System::IO::Stream ^ utf8Json, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Serialize : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unit
Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))
Jenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- value
- TValue
Nilai yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata tentang jenis yang akan dikonversi.
Pengecualian
utf8Json
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Menulis representasi JSON dari jenis yang ditentukan oleh parameter jenis generik ke penulis yang disediakan.
public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions? options = default);
public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions options = default);
static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unit
Public Shared Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)
Public Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)
Jenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- writer
- Utf8JsonWriter
Penulis JSON untuk ditulis.
- value
- TValue
Nilai untuk dikonversi dan ditulis.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku serialisasi.
Pengecualian
writer
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
yang JsonWriterOptions digunakan untuk membuat instans yang Utf8JsonWriter diutamakan daripada JsonSerializerOptions ketika mereka berkonflik. Oleh karena itu, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidation, dan JsonWriterOptions.Encoder digunakan saat menulis.
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi JSON.
Berlaku untuk
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan.
public:
generic <typename TValue>
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unit
Public Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))
Jenis parameter
- TValue
Jenis nilai yang akan diserialisasikan.
Parameter
- writer
- Utf8JsonWriter
Penulis untuk menulis.
- value
- TValue
Nilai untuk dikonversi dan ditulis.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata tentang jenis yang akan dikonversi.
Pengecualian
writer
atau jsonTypeInfo
adalah null
.
Tidak ada yang kompatibel JsonConverter untuk TValue
atau anggotanya yang dapat diserialisasikan.
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