JsonSerializer.Serialize Metode

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-preview.3.24172.9

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)

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 dikonversi dan ditulis.

inputType

Type

Jenis yang akan dikonversi value .

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

writer atau inputType adalah null.

NotSupportedException

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

InvalidOperationException

Metode GetTypeInfo(Type) pengembalian yang disediakan contextnull untuk jenis yang akan dikonversi.

Serialize(Stream, Object, Type, JsonSerializerContext)

Sumber:

JsonSerializer.Write.Stream.cs

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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

Object

Nilai yang akan dikonversi.

inputType

Type

Jenis yang akan dikonversi value .

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

utf8Json, inputType, atau context adalah null.

NotSupportedException

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

Serialize(Stream, Object, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.Stream.cs

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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

Object

Nilai yang akan dikonversi.

inputType

Type

Jenis yang akan dikonversi value .

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku konversi.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

utf8Json atau inputType adalah null.

NotSupportedException

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

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 dikonversi dan ditulis.

jsonTypeInfo

JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

writer atau jsonTypeInfo adalah null.

InvalidCastException

value tidak cocok dengan jenis jsonTypeInfo.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.Utf8JsonWriter.cs

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

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 dikonversi dan ditulis.

inputType

Type

Jenis yang akan dikonversi value .

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku serialisasi.

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value

ArgumentNullException

writer atau inputType adalah null.

NotSupportedException

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.

Serialize(Object, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.String.cs

Mengonversi nilai jenis tertentu 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 yang akan dikonversi value .

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku konversi.

Mengembalikan

String

Representasi string JSON dari nilai .

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

inputTypeadalah null.

NotSupportedException

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.

Serialize(Stream, Object, JsonTypeInfo)

Sumber:

JsonSerializer.Write.Stream.cs

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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

Object

Nilai yang akan dikonversi.

jsonTypeInfo

JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

utf8Jsonadalah 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 String nilai.

Pengecualian

ArgumentNullException

jsonTypeInfoadalah null.

InvalidCastException

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

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

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

String

Representasi String nilai.

Pengecualian

NotSupportedException

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

InvalidOperationException

Metode GetTypeInfo(Type) pengembalian yang disediakan contextnull untuk jenis yang akan dikonversi.

ArgumentNullException

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

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 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.

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 String nilai.

Pengecualian

NotSupportedException

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

ArgumentNullException

jsonTypeInfoadalah 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).

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Sumber:

JsonSerializer.Write.Stream.cs

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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

TValue

Nilai yang akan dikonversi.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku konversi.

Pengecualian

ArgumentNullException

utf8Jsonadalah null.

NotSupportedException

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

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

Sumber:

JsonSerializer.Write.Stream.cs

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

utf8Json

Stream

UTF-8 Stream untuk ditulis.

value

TValue

Nilai yang akan dikonversi.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

utf8Jsonadalah null.

NotSupportedException

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

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 dikonversi dan ditulis.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku serialisasi.

Pengecualian

ArgumentNullException

writeradalah null.

NotSupportedException

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.

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 dikonversi dan ditulis.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Pengecualian

ArgumentNullException

writer atau jsonTypeInfo adalah null.

NotSupportedException

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