DataContractJsonSerializer Klasa

Definicja

Serializuje obiekty w formacie JavaScript Object Notation (JSON) i deserializuje dane JSON do obiektów. Klasa ta nie może być dziedziczona.

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
Dziedziczenie
DataContractJsonSerializer
Dziedziczenie
DataContractJsonSerializer

Uwagi

W przypadku większości scenariuszy obejmujących serializacji do formatu JSON i deserializacji z formatu JSON zalecamy interfejsy API w przestrzeni nazw System.Text.Json.

Jeśli scenariusz wymaga DataContractJsonSerializer klasy, możesz użyć jej do serializacji wystąpień typu w dokumencie JSON i deserializacji dokumentu JSON do wystąpienia typu. Można na przykład utworzyć typ o nazwie Person z właściwościami zawierającymi podstawowe dane, takie jak nazwa i adres. Następnie możesz utworzyć wystąpienie Person klasy i manipulować nim i zapisać wszystkie jej wartości właściwości w dokumencie JSON na potrzeby późniejszego pobierania. Ten dokument JSON można później deserializacji do Person klasy lub innej klasy z równoważnym kontraktem danych.

Jeśli podczas serializacji odpowiedzi wychodzącej na serwerze wystąpi błąd lub operacja odpowiedzi zgłasza wyjątek z jakiegoś innego powodu, może nie zostać zwrócony klientowi jako błąd.

Konstruktory

DataContractJsonSerializer(Type)

Inicjuje DataContractJsonSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Inicjuje DataContractJsonSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu i ustawień serializatora.

DataContractJsonSerializer(Type, IEnumerable<Type>)

Inicjuje nowe wystąpienie DataContractJsonSerializer klasy w celu serializacji lub deserializacji obiektu określonego typu z kolekcją znanych typów, które mogą być obecne na grafie obiektu.

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

Inicjuje DataContractJsonSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również listę znanych typów, które mogą być obecne na grafie obiektu, maksymalną liczbę elementów grafu do serializacji lub deserializacji, czy ignorować nieoczekiwane dane lub emitować informacje o typie oraz zastępcę niestandardowej serializacji.

DataContractJsonSerializer(Type, String)

Inicjuje DataContractJsonSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu przy użyciu elementu głównego XML określonego parametru.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Inicjuje nowe wystąpienie DataContractJsonSerializer klasy w celu serializacji lub deserializacji obiektu określonego typu przy użyciu elementu głównego XML określonego parametru z kolekcją znanych typów, które mogą być obecne na grafie obiektu.

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

Inicjuje DataContractJsonSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również nazwę główną elementu XML, listę znanych typów, które mogą być obecne na grafie obiektu, maksymalną liczbę elementów grafu do serializacji lub deserializacji, niezależnie od tego, czy ignorować nieoczekiwane dane, czy emitować informacje o typie, oraz zastępcę niestandardowej serializacji.

DataContractJsonSerializer(Type, XmlDictionaryString)

Inicjuje DataContractJsonSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu przy użyciu elementu głównego XML określonego typu XmlDictionaryStringokreślonego.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Inicjuje nowe wystąpienie DataContractJsonSerializer klasy w celu serializacji lub deserializacji obiektu określonego typu przy użyciu elementu głównego XML określonego typu określonego przy użyciu parametru typu XmlDictionaryString, z kolekcją znanych typów, które mogą być obecne na grafie obiektu.

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

Inicjuje DataContractJsonSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również nazwę główną elementu XML, listę znanych typów, które mogą być obecne na grafie obiektu, maksymalną liczbę elementów grafu do serializacji lub deserializacji, niezależnie od tego, czy ignorować nieoczekiwane dane, czy emitować informacje o typie, oraz zastępcę niestandardowej serializacji.

Właściwości

DataContractSurrogate

Pobiera typ zastępczy, który jest obecnie aktywny dla danego IDataContractSurrogate wystąpienia. Surogaty mogą rozszerzać proces serializacji lub deserializacji.

DateTimeFormat

Pobiera format elementów typu data i godzina na grafie obiektu.

EmitTypeInformation

Pobiera lub ustawia ustawienia serializatora JSON kontraktu danych, aby emitować informacje o typie.

IgnoreExtensionDataObject

Pobiera wartość określającą, czy nieznane dane są ignorowane podczas deserializacji i czy IExtensibleDataObject interfejs jest ignorowany podczas serializacji.

KnownTypes

Pobiera kolekcję typów, które mogą być obecne w grafie obiektu serializowane przy użyciu tego wystąpienia klasy DataContractJsonSerializer.

MaxItemsInObjectGraph

Pobiera maksymalną liczbę elementów na grafie obiektu, który serializuje lub deserializuje w jednym wywołaniu odczytu lub zapisu.

SerializeReadOnlyTypes

Pobiera lub ustawia wartość określającą, czy serializować typy tylko do odczytu.

UseSimpleDictionaryFormat

Pobiera wartość określającą, czy używać prostego formatu słownika.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetSerializationSurrogateProvider()

Serializuje obiekty w formacie JavaScript Object Notation (JSON) i deserializuje dane JSON do obiektów. Klasa ta nie może być dziedziczona.

GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
IsStartObject(XmlDictionaryReader)

Pobiera wartość określającą, czy XmlDictionaryReader element XML jest umieszczony nad elementem XML reprezentującym obiekt, z którego serializator może deserializować.

IsStartObject(XmlReader)

Określa, czy XmlReader obiekt jest umieszczony na obiekcie, który można deserializować.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ReadObject(Stream)

Odczytuje strumień dokumentu w formacie JSON (JavaScript Object Notation) i zwraca obiekt deserializowany.

ReadObject(XmlDictionaryReader)

Odczytuje dokument XML mapowany z formatu JSON (JavaScript Object Notation) z obiektem XmlDictionaryReader i zwraca obiekt deserializowany.

ReadObject(XmlDictionaryReader, Boolean)

Odczytuje dokument XML mapowany z pliku JSON z obiektem XmlDictionaryReader i zwraca obiekt deserializowany. Umożliwia również określenie, czy serializator powinien sprawdzić, czy jest umieszczony na odpowiednim elemenie przed próbą deserializacji.

ReadObject(XmlReader)

Odczytuje dokument XML mapowany z formatu JSON (JavaScript Object Notation) z obiektem XmlReader i zwraca obiekt deserializowany.

ReadObject(XmlReader, Boolean)

Odczytuje dokument XML mapowany z pliku JSON z obiektem XmlReader i zwraca obiekt deserializowany. Umożliwia również określenie, czy serializator powinien sprawdzić, czy jest on umieszczony na odpowiednim elemecie przed podjęciem próby deserializacji.

SetSerializationSurrogateProvider(ISerializationSurrogateProvider)

Serializuje obiekty w formacie JavaScript Object Notation (JSON) i deserializuje dane JSON do obiektów. Klasa ta nie może być dziedziczona.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
WriteEndObject(XmlDictionaryWriter)

Zapisuje zamykający element XML w dokumencie XML przy użyciu elementu XmlDictionaryWriter, który można zamapować na notację obiektów JavaScript (JSON).

WriteEndObject(XmlWriter)

Zapisuje zamykający element XML w dokumencie XML przy użyciu elementu XmlWriter, który można zamapować na notację obiektów JavaScript (JSON).

WriteObject(Stream, Object)

Serializuje określony obiekt na dane w formacie JavaScript Object Notation (JSON) i zapisuje wynikowy kod JSON do strumienia.

WriteObject(XmlDictionaryWriter, Object)

Serializuje obiekt w formacie XML, który może być mapowany na notację obiektów JavaScript (JSON). Zapisuje wszystkie dane obiektu, w tym początkowy element XML, zawartość i element zamykający z elementem XmlDictionaryWriter.

WriteObject(XmlWriter, Object)

Serializuje obiekt w formacie XML, który może być mapowany na notację obiektów JavaScript (JSON). Zapisuje wszystkie dane obiektu, w tym początkowy element XML, zawartość i element zamykający z elementem XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Zapisuje zawartość XML, która może być mapowana na notację obiektów JavaScript (JSON) przy użyciu elementu XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Zapisuje zawartość XML, która może być mapowana na notację obiektów JavaScript (JSON) przy użyciu elementu XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Zapisuje otwierający element XML służący do serializacji obiektu do formatu XML, który można zamapować na notację obiektów JavaScript (JSON) przy użyciu elementu XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object)

Zapisuje otwierający element XML służący do serializacji obiektu do formatu XML, który można zamapować na notację obiektów JavaScript (JSON) przy użyciu elementu XmlWriter.

Dotyczy