JsonSerializerOptions Kelas

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

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

Sumber:

JsonSerializerOptions.cs

Menyediakan opsi yang akan digunakan dengan JsonSerializer.

public ref class JsonSerializerOptions sealed

public sealed class JsonSerializerOptions

type JsonSerializerOptions = class

Public NotInheritable Class JsonSerializerOptions

Warisan

Object

JsonSerializerOptions

Keterangan

Untuk informasi selengkapnya, lihat Cara menserialisasikan dan mendeserialisasi JSON.

Konstruktor

Nama	Deskripsi
JsonSerializerOptions()	Menginisialisasi instans baru dari kelas JsonSerializerOptions.
JsonSerializerOptions(JsonSerializerDefaults)	Membuat instans baru JsonSerializerOptions dengan sekumpulan opsi yang telah ditentukan sebelumnya yang ditentukan oleh JsonSerializerDefaults.
JsonSerializerOptions(JsonSerializerOptions)	Menyalin opsi dari JsonSerializerOptions instans ke instans baru.

Properti

Nama	Deskripsi
AllowDuplicateProperties	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nama properti duplikat diizinkan saat mendeserialisasi objek JSON.
AllowOutOfOrderMetadataProperties	Mendapatkan atau menetapkan nilai yang menunjukkan apakah properti metadata JSON dapat ditentukan setelah properti reguler dalam objek JSON yang dideserialisasi.
AllowTrailingCommas	Mendapatkan atau menetapkan nilai yang menunjukkan apakah koma tambahan di akhir daftar nilai JSON dalam objek atau array diizinkan (dan diabaikan) dalam payload JSON yang dideserialisasi.
Converters	Mendapatkan daftar konverter yang ditentukan pengguna yang terdaftar.
Default	Mendapatkan instans JsonSerializerOptions singleton baca-saja yang menggunakan konfigurasi default.
DefaultBufferSize	Mendapatkan atau mengatur ukuran buffer default, dalam byte, untuk digunakan saat membuat buffer sementara.
DefaultIgnoreCondition	Mendapatkan atau menetapkan nilai yang menentukan kapan properti dengan nilai default diabaikan selama serialisasi atau deserialisasi. Nilai defaultnya adalah Never.
DictionaryKeyPolicy	Mendapatkan atau mengatur kebijakan yang digunakan untuk mengonversi IDictionary nama kunci ke format lain, seperti camel-casing.
Encoder	Mendapatkan atau mengatur encoder yang akan digunakan saat melarikan diri dari string, atau null untuk menggunakan encoder default.
IgnoreNullValues	Kedaluwarsa. Mendapatkan atau menetapkan nilai yang menunjukkan apakah null nilai diabaikan selama serialisasi dan deserialisasi. Nilai defaultnya adalah false.
IgnoreReadOnlyFields	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang baca-saja diabaikan selama serialisasi. Bidang bersifat baca-saja jika ditandai dengan readonly kata kunci. Nilai defaultnya adalah false.
IgnoreReadOnlyProperties	Mendapatkan atau menetapkan nilai yang menunjukkan apakah properti baca-saja diabaikan selama serialisasi. Nilai defaultnya adalah false.
IncludeFields	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang ditangani selama serialisasi dan deserialisasi. Nilai defaultnya adalah false.
IndentCharacter	Menentukan karakter indentasi yang digunakan saat WriteIndented diaktifkan. Default ke karakter spasi.
IndentSize	Menentukan ukuran indentasi yang digunakan saat WriteIndented diaktifkan. Default ke dua.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah instans saat ini telah dikunci untuk modifikasi pengguna.
MaxDepth	Mendapatkan atau mengatur kedalaman maksimum yang diizinkan saat menserialisasikan atau mendeserialisasi JSON, dengan nilai default 0 menunjukkan kedalaman maksimum 64.
NewLine	Mendapatkan atau mengatur string baris baru untuk digunakan saat WriteIndented adalah true. Secara default nilai sebesar NewLine.
NumberHandling	Mendapatkan atau mengatur objek yang menentukan bagaimana jenis angka harus ditangani saat menserialisasikan atau mendeserialisasi.
PreferredObjectCreationHandling	Mendapatkan atau mengatur penanganan pembuatan objek pilihan untuk properti saat mendeserialisasi JSON.
PropertyNameCaseInsensitive	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nama properti menggunakan perbandingan yang tidak peka huruf besar/kecil selama deserialisasi. Nilai defaultnya adalah false.
PropertyNamingPolicy	Mendapatkan atau menetapkan nilai yang menentukan kebijakan yang digunakan untuk mengonversi nama properti pada objek ke format lain, seperti camel-casing, atau null untuk membiarkan nama properti tidak berubah.
ReadCommentHandling	Mendapatkan atau menetapkan nilai yang menentukan bagaimana komentar ditangani selama deserialisasi.
ReferenceHandler	Mendapatkan atau mengatur objek yang menentukan bagaimana referensi objek ditangani saat membaca dan menulis JSON.
RespectNullableAnnotations	Mendapatkan atau menetapkan nilai yang menunjukkan apakah anotasi nullability harus dihormati selama serialisasi dan deserialisasi.
RespectRequiredConstructorParameters	Mendapatkan atau menetapkan nilai yang menunjukkan apakah parameter konstruktor non-opsional harus ditentukan selama deserialisasi.
Strict	Mendapatkan instans JsonSerializerOptions singleton baca-saja yang menggunakan konfigurasi ketat.
TypeInfoResolver	Mendapatkan atau mengatur pemecah masalah kontrak yang JsonTypeInfo digunakan oleh instans ini.
TypeInfoResolverChain	Mendapatkan daftar penyelesai kontrak berantai JsonTypeInfo yang digunakan oleh instans ini.
UnknownTypeHandling	Mendapatkan atau mengatur objek yang menentukan bagaimana deserialisasi jenis yang dideklarasikan sebagai Object ditangani selama deserialisasi.
UnmappedMemberHandling	Mendapatkan atau mengatur objek yang menentukan bagaimana JsonSerializer menangani properti JSON yang tidak dapat dipetakan ke anggota .NET tertentu saat mendeserialisasi jenis objek.
Web	Mendapatkan instans JsonSerializerOptions singleton baca-saja yang menggunakan konfigurasi web.
WriteIndented	Mendapatkan atau menetapkan nilai yang menunjukkan apakah JSON harus menggunakan pencetakan yang cantik. Secara default, JSON diserialisasikan tanpa spasi kosong tambahan.

Metode

Nama	Deskripsi
AddContext<TContext>()	Kedaluwarsa. Menambahkan baru JsonSerializerContext ke resolusi metadata instans saat ini JsonSerializerOptions .
GetConverter(Type)	Mengembalikan pengonversi untuk jenis yang ditentukan.
GetTypeInfo(Type)	Mendapatkan metadata kontrak yang JsonTypeInfo diselesaikan oleh instans saat ini JsonSerializerOptions .
GetTypeInfo<T>()	Menyediakan opsi yang akan digunakan dengan JsonSerializer.
MakeReadOnly()	Menandai instans saat ini sebagai baca-saja untuk mencegah modifikasi pengguna lebih lanjut.
MakeReadOnly(Boolean)	Menandai instans saat ini sebagai baca-saja yang mencegah modifikasi pengguna lebih lanjut.
TryGetTypeInfo(Type, JsonTypeInfo)	Mencoba untuk menyelesaikan JsonTypeInfo metadata kontrak oleh instans saat ini JsonSerializerOptions .
TryGetTypeInfo<T>(JsonTypeInfo<T>)	Menyediakan opsi yang akan digunakan dengan JsonSerializer.

Metode Ekstensi

Nama	Deskripsi
AddAIContentType(JsonSerializerOptions, Type, String)	Menambahkan jenis konten kustom ke konfigurasi polimorfik untuk AIContent.
AddAIContentType<TContent>(JsonSerializerOptions, String)	Menambahkan jenis konten kustom ke konfigurasi polimorfik untuk AIContent.
GetJsonSchemaAsNode(JsonSerializerOptions, Type, JsonSchemaExporterOptions)	Menghasilkan skema JSON yang sesuai dengan metadata kontrak dari jenis yang ditentukan.