Поделиться через


DataContractJsonSerializer Класс

Определение

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

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
Наследование
DataContractJsonSerializer
Наследование
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, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа. Этот метод также задает список известных типов, которые могут присутствовать в графе объектов, максимальное количество элементов графа для сериализации или десериализации, пропускать ли непредвиденные данные и создавать ли информацию о типе, а также суррогат для пользовательской сериализации.

DataContractJsonSerializer(Type, String)

Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром, с коллекцией известных типов, которые могут присутствовать в графе объекта.

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

Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа. Этот метод также задает корневое имя XML-элемента, список известных типов, которые могут присутствовать в графе объектов, максимальное количество элементов графа для сериализации или десериализации, пропускать ли непредвиденные данные и создавать ли информацию о типе, а также суррогат для пользовательской сериализации.

DataContractJsonSerializer(Type, XmlDictionaryString)

Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром типа XmlDictionaryString.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа с использованием корневого элемента XML, заданного параметром типа XmlDictionaryString, с коллекцией известных типов, которые могут присутствовать в графе объекта.

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

Инициализирует новый экземпляр класса DataContractJsonSerializer для сериализации или десериализации объекта указанного типа. Этот метод также задает корневое имя XML-элемента, список известных типов, которые могут присутствовать в графе объектов, максимальное количество элементов графа для сериализации или десериализации, пропускать ли непредвиденные данные и создавать ли информацию о типе, а также суррогат для пользовательской сериализации.

Свойства

DataContractSurrogate

Возвращает тип суррогата, который в данный момент активен для заданного экземпляра IDataContractSurrogate. Суррогаты могут расширять процесс сериализации и десериализации.

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.

Применяется к