JsonSerializer.Serialize Metode

Definisi

Ruang nama:: System.Text.Json

Rakitan:: System.Text.Json.dll

Paket:: System.Text.Json v11.0.0-preview.5.26302.115

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

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

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

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

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

Berlaku untuk

Serialize(Stream, Object, JsonTypeInfo)

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

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

InvalidCastException

value tidak cocok dengan jenis jsonTypeInfo.

Berlaku untuk

Serialize(Object, Type, JsonSerializerOptions)

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Mengonversi nilai jenis yang ditentukan menjadi string JSON.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> string

static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> string

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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

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

Atribut: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Pengecualian

ArgumentException

inputType tidak kompatibel dengan value.

ArgumentNullException

inputType adalah 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 menserialisasikan dan mendeserialisasi JSON.

Berlaku untuk

Serialize(Object, Type, JsonSerializerContext)

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

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 context yang disediakan null 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).

Berlaku untuk

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

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 jsonTypeInfo adalah null.

InvalidCastException

value tidak cocok dengan jenis jsonTypeInfo.

Berlaku untuk

Serialize(Stream, Object, Type, JsonSerializerOptions)

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Mengonversi nilai yang disediakan ke teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize(System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize(System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

public static void Serialize(System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions -> unit

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions -> unit

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.

Atribut: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

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.

Berlaku untuk

Serialize(Stream, Object, Type, JsonSerializerContext)

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

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

Berlaku untuk

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unit

static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unit

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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)

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

options: JsonSerializerOptions

Opsi untuk mengontrol perilaku serialisasi.

Atribut: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

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 menserialisasikan dan mendeserialisasi JSON.

Berlaku untuk

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

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 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 context yang disediakan null untuk jenis yang akan dikonversi.

Berlaku untuk

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

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

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 jsonTypeInfo adalah null.

NotSupportedException

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

Berlaku untuk

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Sumber:: JsonSerializer.Write.Utf8JsonWriter.cs

Menulis representasi JSON dari jenis yang ditentukan oleh parameter jenis generik ke penulis yang disediakan.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unit

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

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
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)

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

Atribut: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Pengecualian

ArgumentNullException

writer adalah null.

NotSupportedException

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

Keterangan

Untuk informasi selengkapnya, lihat Cara menserialisasikan dan mendeserialisasi JSON.

Berlaku untuk

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

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

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

NotSupportedException

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

Berlaku untuk

Serialize<TValue>(TValue, JsonSerializerOptions)

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Mengonversi nilai jenis yang ditentukan oleh parameter jenis generik menjadi string JSON.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> string

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

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> string

Public Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String

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

Atribut: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Pengecualian

NotSupportedException

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

Keterangan

Untuk informasi selengkapnya, lihat Cara menserialisasikan dan mendeserialisasi JSON.

Berlaku untuk

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

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

Sumber:: JsonSerializer.Write.String.cs

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

jsonTypeInfo adalah null.

Keterangan

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

Berlaku untuk

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Sumber:: JsonSerializer.Write.Stream.cs

Mengonversi nilai yang disediakan ke teks JSON yang dikodekan UTF-8 dan menulisnya ke Stream.

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize<TValue>(System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static void Serialize<TValue>(System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);

public static void Serialize<TValue>(System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions -> unit

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member Serialize : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions -> unit

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.

Atribut: RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Pengecualian

ArgumentNullException

utf8Json adalah null.

NotSupportedException

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

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?