DataContractJsonSerializer Класс

Определение

Пространство имен:

System.Runtime.Serialization.Json

Сборка:

System.Runtime.Serialization.Json.dll

Исходный код:

DataContractJsonSerializer.cs

Сериализует объекты в нотацию объектов JavaScript (JSON) и десериализует данные JSON в объекты. Этот класс не наследуется.

public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer

public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer

type DataContractJsonSerializer = class
    inherit XmlObjectSerializer

Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer

Наследование

Object

XmlObjectSerializer

DataContractJsonSerializer

Комментарии

В большинстве сценариев, связанных с сериализированием в JSON и десериализацией из JSON, мы рекомендуем использовать API в пространстве имен System.Text.Json.

Если в вашем сценарии требуется DataContractJsonSerializer класс , его можно использовать для сериализации экземпляров типа в документ JSON и для десериализации документа JSON в экземпляр типа. Например, можно создать тип Person со свойствами, содержащими такие важные данные, как имя и адрес. Затем можно создать и обработать экземпляр класса Person и записать все значения его свойств в документ JSON для последующего извлечения. Впоследствии этот документ JSON может быть десериализован в класс Person или другой класс с эквивалентным контрактом данных.

Если происходит ошибка при сериализации исходящего ответа на сервере или операция ответа вызывает исключение по какой-либо другой причине, эта ошибка может не вернуться на клиент в качестве сбоя.

Конструкторы

DataContractJsonSerializer(Type)	Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа.
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)	Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа и параметров сериализатора.
DataContractJsonSerializer(Type, IEnumerable<Type>)	Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с помощью коллекции известных типов, которые могут присутствовать в графе объекта.
DataContractJsonSerializer(Type, String)	Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром.
DataContractJsonSerializer(Type, String, IEnumerable<Type>)	Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром, с коллекцией известных типов, которые могут присутствовать в графе объекта.
DataContractJsonSerializer(Type, XmlDictionaryString)	Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром типа XmlDictionaryString.
DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)	Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром типа XmlDictionaryString, с коллекцией известных типов, которые могут присутствовать в графе объекта.

Свойства

DateTimeFormat	Получает формат элементов типа "дата и время" в графе объектов.
EmitTypeInformation	Получает или задает параметры сериализатора контракта данных JSON для выдачи сведений о типе.
IgnoreExtensionDataObject	Возвращает значение, указывающее, игнорируются ли неизвестные данные при десериализации и игнорируется ли интерфейс IExtensibleDataObject при сериализации.
KnownTypes	Возвращает коллекцию типов, которые могут присутствовать в графе объекта, сериализованном с помощью этого экземпляра класса DataContractJsonSerializer.
MaxItemsInObjectGraph	Возвращает максимальное количество элементов в графе объекта, которое сериализатор сериализует или десериализует в одном вызове на чтение или запись.
SerializeReadOnlyTypes	Получает или задает значение, указывающее, следует ли сериализовать типы, доступные только для чтения.
UseSimpleDictionaryFormat	Получает значение, указывающее, следует ли использовать простой формат словаря.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetSerializationSurrogateProvider()	Сериализует объекты в нотацию объектов JavaScript (JSON) и десериализует данные JSON в объекты. Этот класс не наследуется.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsStartObject(XmlDictionaryReader)	Возвращает значение, указывающее, расположен ли объект XmlDictionaryReader над XML-элементом, представляющим объект, из которого сериализатор может выполнить десериализацию.
IsStartObject(XmlReader)	Определяет, расположен ли объект XmlReader на объекте, который может быть десериализован.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ReadObject(Stream)	Выполняет чтение потока документа в формате JSON (нотации объектов JavaScript) и возвращает десериализованный объект.
ReadObject(XmlDictionaryReader)	Выполняет чтение XML-документа, полученного из JSON (нотации объектов JavaScript), с помощью XmlDictionaryReader и возвращает десериализованный объект.
ReadObject(XmlDictionaryReader, Boolean)	Выполняет чтение XML-документа, полученного из JSON, с помощью XmlDictionaryReader и возвращает десериализованный объект; также позволяет задать, должен ли сериализатор перед попыткой выполнить десериализацию проверить, что он расположен на соответствующем элементе.
ReadObject(XmlReader)	Выполняет чтение XML-документа, полученного из JSON (нотации объектов JavaScript), с помощью XmlReader и возвращает десериализованный объект.
ReadObject(XmlReader, Boolean)	Выполняет чтение XML-документа, полученного из JSON, с помощью XmlReader и возвращает десериализованный объект; также позволяет задать, должен ли сериализатор перед попыткой выполнить десериализацию проверить, что он расположен на соответствующем элементе.
SetSerializationSurrogateProvider(ISerializationSurrogateProvider)	Сериализует объекты в нотацию объектов JavaScript (JSON) и десериализует данные JSON в объекты. Этот класс не наследуется.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
WriteEndObject(XmlDictionaryWriter)	Записывает закрывающий XML-элемент в XML-документ (используя XmlDictionaryWriter), который может быть сопоставлен нотации объектов JavaScript (JSON).
WriteEndObject(XmlWriter)	Записывает закрывающий XML-элемент в XML-документ (используя XmlWriter), который может быть сопоставлен нотации объектов JavaScript (JSON).
WriteObject(Stream, Object)	Сериализует указанный объект в данные нотации объектов JavaScript (JSON) и записывает полученные данные JSON в поток.
WriteObject(XmlDictionaryWriter, Object)	Сериализует объект в код XML, который может быть сопоставлен нотации объектов JavaScript (JSON). Записывает все данные объекта, включая начальный XML-элемент, содержимое и закрывающий элемент, с помощью XmlDictionaryWriter.
WriteObject(XmlWriter, Object)	Сериализует объект в код XML, который может быть сопоставлен нотации объектов JavaScript (JSON). Записывает все данные объекта, включая начальный XML-элемент, содержимое и закрывающий элемент, с помощью XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Записывает содержимое XML, которое может быть сопоставлено нотации объектов JavaScript (JSON), используя XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	Записывает содержимое XML, которое может быть сопоставлено нотации объектов JavaScript (JSON), используя XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	Записывает открывающий XML-элемент для сериализации объекта в XML-код, который может быть сопоставлен нотации объектов JavaScript (JSON), используя XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Записывает открывающий XML-элемент для сериализации объекта в XML-код, который может быть сопоставлен нотации объектов JavaScript (JSON), используя XmlWriter.