DataContractJsonSerializer Kelas

Definisi

Menserialisasikan objek ke JavaScript Object Notation (JSON) dan mendeserialisasi data JSON ke objek. Kelas ini tidak dapat diwariskan.

public ref class DataContractJsonSerializer sealed
public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractJsonSerializer
public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractJsonSerializer = class
type DataContractJsonSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractJsonSerializer
Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer
Warisan
DataContractJsonSerializer
Warisan
DataContractJsonSerializer

Keterangan

Untuk sebagian besar skenario yang melibatkan serialisasi ke JSON dan deserialisasi dari JSON, kami merekomendasikan API di namespace System.Text.Json.

Jika skenario Anda memerlukan DataContractJsonSerializer kelas , Anda dapat menggunakannya untuk membuat serialisasi instans jenis ke dalam dokumen JSON dan untuk mendeserialisasi dokumen JSON ke dalam instans jenis. Misalnya, Anda dapat membuat jenis bernama Person dengan properti yang berisi data penting, seperti nama dan alamat. Anda kemudian dapat membuat dan memanipulasi instans Person kelas dan menulis semua nilai propertinya dalam dokumen JSON untuk diambil nanti. Dokumen JSON ini nantinya dapat dideserialisasi ke Person kelas atau kelas lain dengan kontrak data yang setara.

Jika terjadi kesalahan selama serialisasi balasan keluar di server atau operasi balasan melemparkan pengecualian karena beberapa alasan lain, itu mungkin tidak dikembalikan ke klien sebagai kesalahan.

Konstruktor

DataContractJsonSerializer(Type)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis yang ditentukan.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau mendeserialisasi objek dari jenis dan pengaturan serializer yang ditentukan.

DataContractJsonSerializer(Type, IEnumerable<Type>)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis yang ditentukan, dengan kumpulan jenis yang diketahui yang mungkin ada dalam grafik objek.

DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan atau dideserialisasi, apakah akan mengabaikan data yang tidak terduga atau memancarkan informasi jenis, dan pengganti untuk serialisasi kustom.

DataContractJsonSerializer(Type, String)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis tertentu menggunakan elemen akar XML yang ditentukan oleh parameter.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis tertentu menggunakan elemen akar XML yang ditentukan oleh parameter, dengan kumpulan jenis yang diketahui yang mungkin ada dalam grafik objek.

DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan nama akar elemen XML, daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan atau dideserialisasi, apakah akan mengabaikan data yang tidak terduga atau memancarkan informasi jenis, dan pengganti untuk serialisasi kustom.

DataContractJsonSerializer(Type, XmlDictionaryString)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis tertentu menggunakan elemen akar XML yang ditentukan oleh parameter jenis XmlDictionaryString.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis tertentu menggunakan elemen akar XML yang ditentukan oleh parameter jenis XmlDictionaryString, dengan kumpulan jenis yang diketahui yang mungkin ada dalam grafik objek.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Menginisialisasi instans DataContractJsonSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan nama akar elemen XML, daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan atau dideserialisasi, apakah akan mengabaikan data yang tidak terduga atau memancarkan informasi jenis, dan pengganti untuk serialisasi kustom.

Properti

DataContractSurrogate

Mendapatkan jenis pengganti yang saat ini aktif untuk instans tertentu IDataContractSurrogate . Pengganti dapat memperluas proses serialisasi atau deserialisasi.

DateTimeFormat

Mendapatkan format item jenis tanggal dan waktu dalam grafik objek.

EmitTypeInformation

Mendapatkan atau mengatur pengaturan serializer JSON kontrak data untuk memancarkan informasi jenis.

IgnoreExtensionDataObject

Mendapatkan nilai yang menentukan apakah data yang tidak diketahui diabaikan pada deserialisasi dan apakah IExtensibleDataObject antarmuka diabaikan pada serialisasi.

KnownTypes

Mendapatkan kumpulan jenis yang mungkin ada dalam grafik objek yang diserialisasikan menggunakan instans ini dari DataContractJsonSerializer.

MaxItemsInObjectGraph

Mendapatkan jumlah maksimum item dalam grafik objek yang diserialisasikan atau dideserialisasi oleh serializer dalam satu panggilan baca atau tulis.

SerializeReadOnlyTypes

Mendapatkan atau menetapkan nilai yang menentukan apakah akan membuat serialisasi jenis baca saja.

UseSimpleDictionaryFormat

Mendapatkan nilai yang menentukan apakah akan menggunakan format kamus sederhana.

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetSerializationSurrogateProvider()

Menserialisasikan objek ke JavaScript Object Notation (JSON) dan mendeserialisasi data JSON ke objek. Kelas ini tidak dapat diwariskan.

GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
IsStartObject(XmlDictionaryReader)

Mendapatkan nilai yang menentukan apakah XmlDictionaryReader diposisikan di atas elemen XML yang mewakili objek yang dapat dideserialisasi oleh serializer.

IsStartObject(XmlReader)

Menentukan apakah XmlReader diposisikan pada objek yang dapat dideserialisasi.

MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
ReadObject(Stream)

Membaca aliran dokumen dalam format JSON (JavaScript Object Notation) dan mengembalikan objek yang dideserialisasi.

ReadObject(XmlDictionaryReader)

Membaca dokumen XML yang dipetakan dari JSON (JavaScript Object Notation) dengan XmlDictionaryReader dan mengembalikan objek yang dideserialisasi.

ReadObject(XmlDictionaryReader, Boolean)

Membaca dokumen XML yang dipetakan dari JSON dengan XmlDictionaryReader dan mengembalikan objek yang dideserialisasi; ini juga memungkinkan Anda untuk menentukan apakah serializer harus memverifikasi bahwa itu diposisikan pada elemen yang sesuai sebelum mencoba mendeserialisasi.

ReadObject(XmlReader)

Membaca dokumen XML yang dipetakan dari JSON (JavaScript Object Notation) dengan XmlReader dan mengembalikan objek yang dideserialisasi.

ReadObject(XmlReader, Boolean)

Membaca dokumen XML yang dipetakan dari JSON dengan XmlReader dan mengembalikan objek yang dideserialisasi; ini juga memungkinkan Anda untuk menentukan apakah serializer harus memverifikasi bahwa itu diposisikan pada elemen yang sesuai sebelum mencoba mendeserialisasi.

SetSerializationSurrogateProvider(ISerializationSurrogateProvider)

Menserialisasikan objek ke JavaScript Object Notation (JSON) dan mendeserialisasi data JSON ke objek. Kelas ini tidak dapat diwariskan.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
WriteEndObject(XmlDictionaryWriter)

Menulis elemen XML penutup ke dokumen XML, menggunakan XmlDictionaryWriter, yang dapat dipetakan ke JavaScript Object Notation (JSON).

WriteEndObject(XmlWriter)

Menulis elemen XML penutup ke dokumen XML, menggunakan XmlWriter, yang dapat dipetakan ke JavaScript Object Notation (JSON).

WriteObject(Stream, Object)

Menserialisasikan objek tertentu ke data JavaScript Object Notation (JSON) dan menulis JSON yang dihasilkan ke aliran.

WriteObject(XmlDictionaryWriter, Object)

Menserialisasikan objek ke XML yang mungkin dipetakan ke JavaScript Object Notation (JSON). Menulis semua data objek, termasuk elemen XML awal, konten, dan elemen penutup, dengan XmlDictionaryWriter.

WriteObject(XmlWriter, Object)

Menserialisasikan objek ke XML yang mungkin dipetakan ke JavaScript Object Notation (JSON). Menulis semua data objek, termasuk elemen XML awal, konten, dan elemen penutup, dengan XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Menulis konten XML yang dapat dipetakan ke JavaScript Object Notation (JSON) menggunakan XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Menulis konten XML yang dapat dipetakan ke JavaScript Object Notation (JSON) menggunakan XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Menulis elemen XML pembuka untuk membuat serial objek ke XML yang dapat dipetakan ke JavaScript Object Notation (JSON) menggunakan XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object)

Menulis elemen XML pembuka untuk membuat serial objek ke XML yang dapat dipetakan ke JavaScript Object Notation (JSON) menggunakan XmlWriter.

Berlaku untuk