JsonSerializer.Serialize Metode

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-rc.1.24431.7

Overload

Serialize(Stream, Object, Type, JsonSerializerContext)	Mengonversi nilai yang disediakan ke teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)	Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)	Menulis representasi JSON dari jenis yang ditentukan ke penulis yang disediakan.
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)	Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan.
Serialize(Stream, Object, Type, JsonSerializerOptions)	Mengonversi nilai yang disediakan ke teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
Serialize(Object, Type, JsonSerializerOptions)	Mengonversi nilai jenis yang ditentukan menjadi string JSON.
Serialize(Stream, Object, JsonTypeInfo)	Mengonversi nilai yang disediakan ke 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>(Utf8JsonWriter, TValue, JsonSerializerOptions)	Menulis representasi JSON dari jenis yang ditentukan oleh parameter jenis generik ke penulis yang disediakan.
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 ke teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)	Mengonversi nilai yang disediakan ke teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)	Menulis satu nilai JSON (termasuk objek atau array) ke penulis yang disediakan.

Serialize(Stream, Object, Type, JsonSerializerContext)

Sumber:

JsonSerializer.Write.Stream.cs

Mengonversi nilai yang disediakan ke 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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

Object

Nilai yang akan dikonversi.

inputType

Type

Jenis value yang akan dikonversi.

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

utf8Json, inputType, atau contextnull.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk inputType atau anggotanya yang dapat diserialisasikan.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Sumber:

JsonSerializer.Write.Utf8JsonWriter.cs

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 mengonversi dan menulis.

inputType

Type

Jenis value yang akan dikonversi.

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

writer atau inputTypenull.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk inputType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) dari context yang disediakan mengembalikan null untuk jenis yang akan dikonversi.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.Utf8JsonWriter.cs

Menulis representasi JSON dari jenis yang ditentukan ke penulis yang disediakan.

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 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 mengonversi dan menulis.

inputType

Type

Jenis value yang akan dikonversi.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku serialisasi.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value

ArgumentNullException

writer atau inputTypenull.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk inputType atau anggotanya yang dapat diserialisasikan.

Keterangan

JsonWriterOptions yang digunakan untuk membuat instans Utf8JsonWriter lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidation, dan JsonWriterOptions.Encoder digunakan saat menulis.

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Sumber:

JsonSerializer.Write.Utf8JsonWriter.cs

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 mengonversi dan menulis.

jsonTypeInfo

JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

writer atau jsonTypeInfonull.

InvalidCastException

value tidak cocok dengan jenis jsonTypeInfo.

Serialize(Stream, Object, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.Stream.cs

Mengonversi nilai yang disediakan ke 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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

Object

Nilai yang akan dikonversi.

inputType

Type

Jenis value yang akan dikonversi.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku konversi.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

utf8Json atau inputTypenull.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk inputType atau anggotanya yang dapat diserialisasikan.

Serialize(Object, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.String.cs

Mengonversi nilai jenis yang ditentukan menjadi string JSON.

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 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 value yang akan dikonversi.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku konversi.

Mengembalikan

String

Representasi string JSON dari nilai .

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

inputType null.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk inputType atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan String 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 mendeserialisasi JSON.

Serialize(Stream, Object, JsonTypeInfo)

Sumber:

JsonSerializer.Write.Stream.cs

Mengonversi nilai yang disediakan ke 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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

Object

Nilai yang akan dikonversi.

jsonTypeInfo

JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

utf8Json null.

InvalidCastException

value tidak cocok dengan jenis jsonTypeInfo.

Serialize(Object, JsonTypeInfo)

Sumber:

JsonSerializer.Write.String.cs

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

String

Representasi nilai String.

Pengecualian

ArgumentNullException

jsonTypeInfo null.

InvalidCastException

value tidak cocok dengan jenis jsonTypeInfo.

Keterangan

Menggunakan String tidak seefisien menggunakan pengodean UTF-8 karena implementasinya secara internal menggunakan UTF-8. Lihat juga SerializeToUtf8Bytes(Object, JsonTypeInfo) dan SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).

Serialize(Object, Type, JsonSerializerContext)

Sumber:

JsonSerializer.Write.String.cs

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 value yang akan dikonversi.

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

String

Representasi nilai String.

Pengecualian

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk inputType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) dari context yang disediakan mengembalikan null untuk jenis yang akan dikonversi.

ArgumentNullException

inputType atau contextnull.

Keterangan

Menggunakan String tidak seefisien menggunakan pengodean UTF-8, karena implementasinya secara internal menggunakan UTF-8. Lihat juga SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) dan SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.Utf8JsonWriter.cs

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);

static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unit

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 mengonversi dan menulis.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku serialisasi.

Pengecualian

ArgumentNullException

writer null.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

JsonWriterOptions yang digunakan untuk membuat instans Utf8JsonWriter lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidation, dan JsonWriterOptions.Encoder digunakan saat menulis.

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Serialize<TValue>(TValue, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.String.cs

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);

static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> 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

String

Representasi string JSON dari nilai .

Pengecualian

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan String 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 mendeserialisasi JSON.

Serialize<TValue>(TValue, JsonTypeInfo<TValue>)

Sumber:

JsonSerializer.Write.String.cs

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

String

Representasi nilai String.

Pengecualian

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

ArgumentNullException

jsonTypeInfo null.

Keterangan

Menggunakan String tidak seefisien menggunakan pengodean UTF-8 karena implementasinya secara internal menggunakan UTF-8. Lihat juga SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) dan SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.Stream.cs

Mengonversi nilai yang disediakan ke 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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

TValue

Nilai yang akan dikonversi.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku konversi.

Pengecualian

ArgumentNullException

utf8Json null.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)

Sumber:

JsonSerializer.Write.Stream.cs

Mengonversi nilai yang disediakan ke 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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

TValue

Nilai yang akan dikonversi.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

utf8Json null.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)

Sumber:

JsonSerializer.Write.Utf8JsonWriter.cs

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 mengonversi dan menulis.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

writer atau jsonTypeInfonull.

NotSupportedException

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.